Page Comparison

...

The OSID

...

View

You can look at the OSID Specification schema for its specification terminology. It defines:

• osid: a bunch of interfaces an enumerations
• enumeration: a list of values
• interface: a bunch of method definitions
• method: something that is invoked with parameters, returns a value or an error
• parameter: defines what may be supplied to a method as an argument, can be an interface, enumeration, or a language primitive
• return: defines what may be returned from a method, if anything, can be an interface, enumeration, or a language primitive
• language primitive: boolean, byte, cardinal. decimal integer, object. string, timestamp
• error: an error from a method such as OPERATION_FAILED or ILLEGAL_STATE
• compliance: a compliance statement for a method - mandatory or optional

The Java

...

View

• package: a bunch of interfaces, classes, enums, annotations, and annotationsother 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 

The OSID Specification is transformed into the OSID Java Binding. The resulting merge creates the following terminology in Java:

• osid: a bunch of packages
• package: a bunch of interfaces and enums, and other sub-packages
• enums: constants and methods
• interface: a bunch of method definitions
• 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 an interface, enum, or a primitive
• return: defines the type of return value, can be an interface, enum, primitive, or void
• primitive: boolean, byte, or long
• exception: an error from a method such as such as OperationFailedException or IllegalStateException 

Concepts like classes and objects disappear. Others like parameter, exception, and primitive have a narrower connotation than what a Java developer would be accustomed.