| | {include:pageTitle=OG_HEADER} |
| | The ObjectGrid provides several features that are accessed programmatically using the Java programming language, through several application programming interfaces (APIs) and system programming interfaces. |
| | |
| | The following diagram illustrates the overview of the ObjectGrid programming model: |
| | |
| | !OG_IMAGES^OG_ProgrammingOverview_01.gif|align=center!\\ |
| | \\ |
| | \\ \\ |
| | |
| | When you are using ObjectGrid APIs, you must distinguish between transactional and non-transactional operations. A transactional operation is an operation that is performed within a transaction. In the diagram, ObjectMap, EntityManager, Query, and DataGrid API are transactional APIs that are contained inside the Session that is a transactional container. Non-transactional operations have nothing to do with a transaction, such as configuration operations. The ObjectGrid, BackingMap, and plug-in APIs are non-transactional. |
| | |
| | The ObjectGrid, BackingMap, and other configuration APIs are categorized as ObjectGrid Core API. Plug-ins are for customizing the cache to achieve desired functions and are categorized as the System Programming API. A plug-in in ObjectGrid is a component that provides a certain type of function to the pluggable ObjectGrid components that include ObjectGrid and BackingMap. A feature represents a specific function or characteristic of an ObjectGrid component, including ObjectGrid, Session, BackingMap, ObjectMap, and so on. Usually, features are configurable with configuration APIs. Plug-ins can be built-in, but might require that you develop your own plug-ins in some situations. |
| | |
| | In a normal situation, you should be able to configure the ObjectGrid and BackingMap to meet your application requirements. When the application has special requirements, consider using specialized plug-ins. ObjectGrid might have built-in plug-ins that meet your requirements. For example, if you need a peer-to-peer replication model between two ObjectGrid instances or two ObjectGrid clusters, the built-in [JMSObjectGridEventListener|http://www.ibm.com/developerworks/wikis/objectgridprog/docs/api/com/ibm/websphere/objectgrid/plugins/builtins/JMSObjectGridEventListener.html] is available. If none of the built-in plug-ins can solve your business problems, refer to the System Programming API to provide your own plug-ins. |
| | |
| | ObjectMap is a simple map-based API. If the cached objects are simple and no relationship is involved, the ObjectMap API is ideal for your application. If object relationships are involved, use the EntityManager API. |
| | |
| | | Query is a powerful mechanism for finding data in the ObjectGrid. Both Session and EntityManager provide the traditional query capability. The ObjectGrid also provides continuous query capability over streaming data with the ObjectGrid stream query API. |
| | | Query is a powerful mechanism for finding data in the ObjectGrid. Both Session and EntityManager provide the traditional query capability. The ObjectGrid also provides continuous query capability over streaming data with the ObjectGrid stream-query API. |
| | |
| | The DataGrid API is a powerful computing capability in a distributed ObjectGrid environment that involves many machines, replicas, and partitions. Applications can run business logic in parallel in all of the nodes in the distributed ObjectGrid environment. The application can obtain the DataGrid API through the ObjectMap API. |
| | |
| | h3. [ObjectGrid Core API|ObjectGrid core programming API] |
| | |
| | {excerpt-include:ObjectGrid Core Programming API|nopanel=true} |
| | |
| | h3. [ObjectMap API|ObjectGrid ObjectMap Programming API] |
| | |
| | {excerpt-include:ObjectGrid ObjectMap Programming API|nopanel=true} |
| | |
| | h3. [EntityManager API|ObjectGrid EntityManager Programming API] |
| | |
| | {excerpt-include:ObjectGrid EntityManager Programming API|nopanel=true} |
| | |
| | h3. [Query APIs| ObjectGrid Query APIs] |
| | |
| | {excerpt-include:ObjectGrid Query APIs|nopanel=true} |
| | |
| | h3. [DataGrid API|ObjectGrid DataGrid API] |
| | |
| | {excerpt-include:ObjectGrid DataGrid API|nopanel=true} |
| | |
| | h3. [Embedded Server API|Embedded server API] |
| | |
| | {excerpt-include:Embedded Server API|nopanel=true} |
| | |
| | h3. [ObjectGrid system programming API] |
| | |
| | {excerpt-include:ObjectGrid System Programming API|nopanel=true} |
| | {include:pageTitle=OG_FOOTER} |
