Open service interface definition: Difference between revisions

Revision as of 18:20, 20 April 2009

Latest revision as of 06:51, 18 July 2023

(18 intermediate revisions by 14 users not shown)

Line 1:

{{no footnotes|date=July 2023}}

[[Image:Oki-logo.png|right]]

An '''Openopen Serviceservice Interfaceinterface Definitionsdefinition''' ('''OSIDsOSID''') areis a programmatic interface [[specifications]]specification describing servicesa service. These interfaces are specified by the [[Open Knowledge Initiative]] ('''O.K.I.'''OKI) to implement a [[Serviceservice-Orientedoriented Architecturearchitecture]] (SOA) to achieve [[interoperability]] among applications across a varied base of underlying and changing technologies.

== Rationale ==

To preserve the investment in [[software engineering|development]], program logic is separated from underlying technologies through the use of software interfaces each of which defines a contract between a service [[consumer]] and a [[service provider]]. This separation is the basis of any valid SOA. While some methods define the service interface boundary at a protocol or server level, '''OSIDs''' place the boundary at the application level to effectively insulate the consumer from [[Protocol (computing)|protocols]], server identities, and utility libraries that are in the ___domain to a service provider resulting in software which is easier to develop, longer lasting, and usable across a wider array of computing environments.

To preserve the investment in [[software engineering|development]], program logic is separated from underlying technologies through the use of software interfaces each of which defines a contract between a service [[consumer]] and a [[service provider]]. This separation is the basis of any valid SOA. While some methods define the service interface boundary at a protocol or server level, '''OSIDs''' place the boundary at the application level to effectively insulate the consumer from [[Protocol (computing)|protocols]], server identities, and utility libraries that are in the ___domain to a service provider resulting in software which is easier to develop, longer -lasting, and usable across a wider array of computing environments.

'''OSIDs''' assist in [[software design]] and development by breaking up the problem space across service interface boundaries. Because network communication issues are addressed within a service provider and ''below'' the interface, there isn't an assumption that every service provider implement a remote communications protocol (though many do). OSIDs are also used for communication and coordination among the various components of complex software which provide a means of organizing design and development activities for simplified [[project management]].

'''OSIDs''' assist in [[software design]] and development by breaking up the problem space across service interface boundaries. Because network communication issues are addressed within a service provider and ''below'' the interface, there isn't an assumption that every service provider implement a remote communications protocol (though many do). OSIDs are also used for communication and coordination among the various components of complex software which provide a means of organizing design and development activities for simplified [[project management]].

OSID providers (implementations) are often reused across a varied set of applications. Once software is made to understand the interface contract for a service, other compliant implementations may be used in its place. This achieves [[reusability]] at a high level (a service level) and also serves to easily scale software written for smaller more dedicated purposes.

Line 11 ⟶ 13:

An OSID provider implementation may be composed of an arbitrary number of other OSID providers. This layering technique is an obvious means of [[abstraction]]. When all the OSID providers implement the same service, this is called an ''adapter'' pattern. Adapter patterns are powerful techniques to federate, multiplex, or bridge different services contracting from the same interface without the modification to the application.

==Service definitionsList ==

* Agent

* [[Agent Open Service Interface Definition|Agent]]

* Assessment

* [[Assessment Open Service Interface Definition|Assessment]]

* [[Authentication Open Service Interface Definition|Authentication]]

* [[Authorization Open Service Interface Definition|Authorization]]

* [[CourseManagement Open Service Interface Definition|CourseManagement]]

* Dictionary

* [[Dictionary Open Service Interface Definition|Dictionary]]

* Filing

* [[Filing Open Service Interface Definition|Filing]]

* Grading

* [[Grading Open Service Interface Definition|Grading]]

* Hierarchy

* [[Hierarchy Open Service Interface Definition|Hierarchy]]

* Logging

* [[Logging Open Service Interface Definition|Logging]]

* Messaging

* [[Messaging Open Service Interface Definition|Messaging]]

* Repository

* [[Repository Open Service Interface Definition|Repository]]

* Scheduling

* [[Scheduling Open Service Interface Definition|Scheduling]]

* Workflow

* [[Workflow Open Service Interface Definition|Workflow]]

== See alsoReferences ==

* [[Open Knowledge Initiative]]

* [http://simba.cs.uct.ac.za/~honsproj/cgi-bin/view/2003/baving_green.zip/baving_green/coursetool/downloads/paper.pdf Baving, T., Cook, D., Green, T. ''Integrating the Educational Enterprise''. 2003.]

==References==

* Thorne, Scott. [http://www.okiproject.org/viewdocuments/html/site/oki/node/1341OKIandIMS-WiresAndSocketsRevisited.pdf Kraan, W. ''ConceptualO.K.I. and IMS, wires and Architecturalsockets Frameworkrevisited''].]

* [http://www.okiproject.org/library/doc_41.html Kahn, J. ''Screen Shots: Repository OSID Interoperability''. 2005.]

* [http://www.okiproject.org/filemgmt/visit.php?lid=44 Kumar, V., Merriman, J., Thorne, S. ''Open Knowledge Initiative Final Report''. 2004.]

* [http://okiproject.org/filemgmt-data/files/RepositoryDevelopersGuide-v1.0.pdf Kahn, J. ''Repository Developer's Guide''. 2006.]

* [http://www.okiproject.org/documents/OKIManagingComplexity_rel_1_0.pdf Kahn, J. ''Managing Complexity and Surviving Technology Change''. 2005.]

== External links ==

* [http://sourceforge.net/projects/okiproject Download specifications] at SourceForge

* [{{Official website|http://www.okiprojectosid.org O.K.I. Project]}}

* [https://okapia.atlassian.net/wiki/spaces/OSID/overview OSID wiki]

* [https://web.archive.org/web/20081226161331/http://www.phpoki.org/ PHP OSIDs]

{{internet-stub}}

[[Category:Software architecture]]