Yes, I’m late to the party, however…..<\/p>\n
I’m finally beginning to create Domino Web Service providers.\u00a0 (If you’re not family with the IBM Lotus Notes\/Domino environment, you need read no further.)<\/p>\n
I have located several good reference pages by Julian Rubichaux, but still felt like there was some information missing that I couldn’t seem to locate, so I began a series of experiments.<\/p>\n
As a result, I’ve begun compiling a summary of thoughts and standards for my environment, some of which I’ll mention here.<\/p>\n
Don’t put any code in your web service.<\/strong> Instead, have your web service class inherit from a class defined in a script library. This class in turn inherits many standard elements from a base class in another script library.\u00a0 While it means you have to go through a couple of extra steps to refresh the service, it means you are able to employ code reuse on a massive scale.\u00a0 It also means you get better “Intellisense” capability (or whatever IBM calls it).<\/p>\n Define standard classes for your common return values,<\/strong> especially arrays, lists, date\/time things, and NotesDocuments, and include them in the base class mentioned a moment ago.<\/p>\n Develop and use a standard error handling approach for all errors.<\/strong> In my case, I leverage Julian’s OpenLog.NSF tool for capturing errors internally, but return a generic error to the web service so as to hide any details about our underlying data structures. I have augmented Julian’s code so that it generates a “cascading log” entry, similar to a stack trace, that shows the call history of the problem area. This helps me debug the problem in my code.<\/p>\n Give serious thought to security.<\/strong> I’m still trying to figure out how to pass Domino credentials into a web service, but I’ve come up with a fairly robust work-around in the meantime. Perhaps I’ll describe it another time, but since it relates to security, maybe not right away!<\/p>\n <\/strong>There’s a lot more that I still need to explore and develop.\u00a0 I’ll update this entry as time allows.<\/p>\n Note: my environment uses Domino version 8.5.3 but I think these guidelines are generic enough that you can use them from version 7.0.1 on.<\/em><\/p>\n Recommended free tool<\/strong> to use when testing Web Services: SoapUI.<\/strong>\u00a0 It saves you from having to debug two halves of the web service puzzle at the same time.<\/p>\n","protected":false},"excerpt":{"rendered":" Yes, I’m late to the party, however….. I’m finally beginning to create Domino Web Service providers.\u00a0 (If you’re not family with the IBM Lotus Notes\/Domino environment, you need read no further.) I have located several good reference pages by Julian Rubichaux, but still felt like there was some information missing that I couldn’t seem to […]<\/p>\n","protected":false},"author":10785,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[16],"tags":[],"class_list":["post-118","post","type-post","status-publish","format-standard","hentry","category-ibm-notes-lotus-notes"],"_links":{"self":[{"href":"https:\/\/blogs.callutheran.edu\/jpdillon\/wp-json\/wp\/v2\/posts\/118","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogs.callutheran.edu\/jpdillon\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.callutheran.edu\/jpdillon\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.callutheran.edu\/jpdillon\/wp-json\/wp\/v2\/users\/10785"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.callutheran.edu\/jpdillon\/wp-json\/wp\/v2\/comments?post=118"}],"version-history":[{"count":6,"href":"https:\/\/blogs.callutheran.edu\/jpdillon\/wp-json\/wp\/v2\/posts\/118\/revisions"}],"predecessor-version":[{"id":120,"href":"https:\/\/blogs.callutheran.edu\/jpdillon\/wp-json\/wp\/v2\/posts\/118\/revisions\/120"}],"wp:attachment":[{"href":"https:\/\/blogs.callutheran.edu\/jpdillon\/wp-json\/wp\/v2\/media?parent=118"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.callutheran.edu\/jpdillon\/wp-json\/wp\/v2\/categories?post=118"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.callutheran.edu\/jpdillon\/wp-json\/wp\/v2\/tags?post=118"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}