...
| Table of Contents | ||
|---|---|---|
|
The OSID
...
Perspective
You can look at the OSID Specification schema for its specification terminology. It defines:
...
| Gliffy | ||||||
|---|---|---|---|---|---|---|
|
The
...
Java Perspective
- package: a bunch of interfaces, classes, enums, annotations, and other sub-packages
- enums: constants and methods
- interface: a bunch of method definitions
- class: a pile of attributes that include methods and may implement one or more interfaces
- object: an instance of a single class
- method: something that is invoked with parameters, returns a value or throws an exception
- parameter: defines the type supplied to a method as an argument, can be a class, interface, enum, or a primitive
- return: defines the type of return value, can be a class, interface, enum, primitive, or void
- primitive: boolean, byte, char, double, float, int, long, short
- exception: an event that occurs during the execution of a program that disrupts the normal flow of instructions such as SecurityException or NullPointerException
...
Concepts like classes and objects disappear. Others like parameter and primitive have a narrower connotation than what a Java developer would be accustomed. And the definition of "osid" gets fuzzier.
...
The Web Services View
- endpoint: a
- enums: constants and methods
...
Other Terminology Problems
Attributes & Data Fields
Service entities, such as OsidObjects, are expressed using interfaces. While a display name or description is generally treated as an attribute, this would only known to an OSID Provider. What is presented to an OSID Consumer is the means for accessing the value at that point in time. Yes, OSID Providers can provide real time information through its methods and so OSIDs do not call these attributes or data fields.
Contract
The term contract is often used in service designs to distinguish an interface from a message structure or DTO. The message structure and DTO are considered data while the contract defines the operations on that data. OSIDs define the contractual agreement between service consumers and service providers. In the OSID world, everything in the specification is a contract. This term doesn't help qualify anything here.
DTO
A Data Transfer Object is used to transfer bags of data through system layers where, ideally, the DTO has some semantic meaning in an entity model. OSIDs do not have a concept of data, just method signatures in interfaces.
Endpoint
Entity
Message Structure
Operations
Relation
Service
The term "service" doesn't have any formal definition in the OSID Specification. It's tossed around because this is a Service Design Methodology.
Standard
| Gliffy | ||||||
|---|---|---|---|---|---|---|
|