(r3) XeoPrimerJavaAPI < WebXEO

WebXEO Web>XeoPrimer>XeoPrimerJavaAPI (revision 3) (raw view)~~EditAttach~~

-- Main.PedroRio - 22 Dec 2010
---+ XEO Java API

The XEO Java API allows direct interaction with a XEO Application (instances of Object Models and Object Model definitions). It can be used in the following situations:
   * Custom Behavior definition (for Object Model Events, Methods, Attribute Events and Attribute Logic (requirement, validation, etc...)
   * To create Schedules and Threads that perform background operations on instances of Object Models
   * Custom developing around a XEO Application (ex. Java Server Pages, Servlets, Java Server Faces)
   * Creating XEO Modules
   * Applications sharing the same J2EE server as the XEO application who want to access information in Object Model instances.
---++++ Basic Concepts

A XEO application is all about creating instances of Object Models, setting values for their attributes, processing lists of Object Model instances, handling events generated for those instances and executing methods. The Java API

A XEO application has a entry point which is an instance of the _boApplication_. The boApplication instance provides access to most features of the XEO Java API, however most of the the extension points (such as Object Model Behavior) are located inside classes which have direct access to some of classes which are required to use the Java API

aa

---++++ boApplication

aaaa
---++++ boSession and EboContext

Whenever a user successfully a
---++++ boObject

aaa
---++++ boObjectList

aaa
---++++ AttributeHandler & BridgeHandler

ssss
---++++ boDefHandler

aaaa

<strong><em>___</em></strong>
---+++ Relations between XEO Java Classes

To help understand the relation between the most important Java classes of the XEO API and how to have access them, see the two following figures (separated due to their size)

<img width="960" alt="JavaAPI - Part1" src="http://wiki.itds.pt/pub/WebITDS/XeoPrimerJavaAPI/JavaAPI-Part1.png" title="JavaAPI - Part1" height="720" />

__Figure JA.1 - Relations between__

<img width="960" alt="JavaAPI - Part2" src="http://wiki.itds.pt/pub/WebITDS/XeoPrimerJavaAPI/JavaAPI-Part2.png" title="JavaAPI - Part2" height="720" />

__Figure JA.2 - Relations between Java class__

aaa
---+++ Sample Workflow Code - Creating an instance, set attribute values and save the instance

The XEO Java API can be used arbitrarily to fit your needs, but to illustrate a situation where one needs to create an instance of Object Model A, set the value of two attributes (att1 and att2) and save the instance see the following code.
<verbatim>try{
            //Get the application instance
            boApplication app = boApplication.getDefaultApplication();
            //Login a user
            boSession session = app.boLogin("SYSUSER", "ABC");
            //Create a context
            EboContext ctx = app.createContext(session);
            //Retrieve the Object Manager
            boManagerBean objectManager = (boManagerBean) app.getObjectManager();
            //Create a new instance object for Class "A"
            boObject obj = objectManager.createObject(ctx, "A");
            //Retrieve attributes and set their value
            obj.getAttribute("att1").setValueString("my Value");
            obj.getAttribute("att2").setValueBoolean(true);
            //In the end, update the object
            obj.update();
            //Close all resources
            ctx.close();
            session.close();
        }
catch (boLoginException e) {
   //Log login error
} catch (boRuntimeException e) {
   //Write to log, or somethin
}</verbatim>

_

aa

<strong><em><br /></em></strong>

Attachments

Topic attachments
I	Attachment	Action	Size	Date	Who	Comment
png	JavaAPI-Part1.png	manage	39.3 K	2010-12-29 - 16:45	PedroRio	XEO Java API Relations
png	JavaAPI-Part2.png	manage	30.9 K	2010-12-29 - 16:45	PedroRio	XEO Java API Relations Part2

Topic revision: r3 - 2010-12-29 - PedroRio

No permission to view TWiki.WebTopBar

No permission to view TWiki.WebBottomBar