Package rasj.odmg

Class RasODMGImplementation

java.lang.Object

rasj.odmg.RasODMGImplementation

All Implemented Interfaces:

Implementation, RasCommDefs, RasImplementationInterface

public class RasODMGImplementation
extends Object
implements RasImplementationInterface, RasCommDefs

This class implements the internal ODMG Bootstrap Object used by the rasj.odmg package. Because it contains a lot of functionality for internal purposes (e.g. methods for the RasManager), this class is not the official Implementation object the user works with, it is only used by the rasj.odmg package.

The public Implementation object is the class rasj.RasImplementation, which internally works with a RasODMGImplementation object.

See Also:

• RasImplementation

Field Summary

Fields inherited from interface rasj.clientcommhttp.RasCommDefs

BIG_ENDIAN, BROWSER, LITTLE_ENDIAN, RASCLIENT, RESPONSE_ERROR, RESPONSE_INT, RESPONSE_MDDS, RESPONSE_OID, RESPONSE_OK, RESPONSE_OK_NEGATIVE, RESPONSE_SKALARS

Constructor Summary

Constructors

Constructor	Description
RasODMGImplementation(String server)	Standard constructor.

Method Summary

Modifier and Type	Method	Description
void	abortTA()	Abort a transaction.
void	beginTA()	Begin a transaction.
void	closeDB()	Closes an open database.
void	commitTA()	Commit a transaction.
void	connectClient(String userName, String passwordHash)
Transaction	currentTransaction()	Get current transaction for thread, or NULL if none.
int	dbIsOpen()	Tells whether database is open.
void	disconnectClient()
int	getAccessMode()	Gets the database access mode
String	getBodyLine(BufferedReader ds)
int	getClientID()	Gets the client ID
Database	getDatabase(Object obj)	Not implemented yet.
String	getErrorStatus()	Gets the current error status
void	getFreeServer()	Requests a free server and retry's
int	getMaxRetry()	Get the maximum retry parameter
String	getObjectId(Object obj)	Get a String representation of the object's identifier.
String	getRasServer()	Gets the name of the actual server.
int	getResultCode(BufferedReader ds)
String	getTypeStructure(String typename, int typetype)
boolean	isOpenTA()	Returns TRUE if a transaction is currently open.
DArray	newDArray()	Not implemented yet.
Database	newDatabase()	Create a new database object.
DBag	newDBag()	Create a new DBag object.
DList	newDList()	Create a new DList object.
DMap	newDMap()	Not implemented yet.
DSet	newDSet()	Create a new DSet object.
OQLQuery	newOQLQuery()	Create a new query object.
Transaction	newTransaction()	Create a new transaction object and associate it with the current thread.
void	openDB(String name, int accessMode)	Open database
Object	queryRequest(String parameters)
void	setMaxRetry(int newRetry)	Set the maximum retry parameter
void	setUserIdentification(String userName, String plainPass)
void	setUserIdentificationHashed(String userName, String passwordMD5Hash)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

RasODMGImplementation

public RasODMGImplementation(String server)

Standard constructor.

Parameters:

server - Complete URL of the RasDaMan httpserver (including port number)

Method Details

getRasServer

public String getRasServer()

Gets the name of the actual server.

Specified by:

getRasServer in interface RasImplementationInterface

Returns:

the name of the RasDaMan server used

dbIsOpen

public int dbIsOpen()

Tells whether database is open.

Specified by:

dbIsOpen in interface RasImplementationInterface

Returns:

open status of database

getClientID

public int getClientID()

Gets the client ID

Specified by:

getClientID in interface RasImplementationInterface

Returns:

ID of this client

getAccessMode

public int getAccessMode()

Gets the database access mode

Specified by:

getAccessMode in interface RasImplementationInterface

Returns:

accessMode code: OPEN_READ_ONLY = 1; OPEN_READ_WRITE = 2; OPEN_EXCLUSIVE = 3

getErrorStatus

public String getErrorStatus()

Gets the current error status

Specified by:

getErrorStatus in interface RasImplementationInterface

Returns:

error status string

newTransaction

public Transaction newTransaction()

Create a new transaction object and associate it with the current thread.

Specified by:

newTransaction in interface Implementation

Specified by:

newTransaction in interface RasImplementationInterface

Returns:

The newly created Transaction instance.

See Also:

• Transaction

currentTransaction

public Transaction currentTransaction()

Get current transaction for thread, or NULL if none.

Specified by:

currentTransaction in interface Implementation

Specified by:

currentTransaction in interface RasImplementationInterface

Returns:

The current Transaction object or null if there is none.

See Also:

• Transaction

newDatabase

public Database newDatabase()

Create a new database object.

Specified by:

newDatabase in interface Implementation

Specified by:

newDatabase in interface RasImplementationInterface

Returns:

The new Database object.

See Also:

• Database

newOQLQuery

public OQLQuery newOQLQuery()

Create a new query object.

Specified by:

newOQLQuery in interface Implementation

Specified by:

newOQLQuery in interface RasImplementationInterface

Returns:

The new OQLQuery object.

See Also:

• OQLQuery

newDList

public DList newDList()

Create a new DList object.

Specified by:

newDList in interface Implementation

Specified by:

newDList in interface RasImplementationInterface

Returns:

The new DList object.

See Also:

• DList

newDBag

public DBag newDBag()

Create a new DBag object.

Specified by:

newDBag in interface Implementation

Specified by:

newDBag in interface RasImplementationInterface

Returns:

The new DBag object.

See Also:

• DBag

newDSet

public DSet newDSet()

Create a new DSet object.

Specified by:

newDSet in interface Implementation

Specified by:

newDSet in interface RasImplementationInterface

Returns:

The new DSet object.

See Also:

• DSet

newDArray

public DArray newDArray()

Not implemented yet.

Specified by:

newDArray in interface Implementation

Specified by:

newDArray in interface RasImplementationInterface

Returns:

The new DArray object.

See Also:

• DArray

newDMap

public DMap newDMap()

Not implemented yet.

Specified by:

newDMap in interface Implementation

Specified by:

newDMap in interface RasImplementationInterface

Returns:

The new DMap object.

See Also:

• DMap

getObjectId

public String getObjectId(Object obj)

Get a String representation of the object's identifier.

Specified by:

getObjectId in interface Implementation

Specified by:

getObjectId in interface RasImplementationInterface

Parameters:

obj - The object whose identifier is being accessed.

Returns:

The object's identifier in the form of a String

getDatabase

public Database getDatabase(Object obj)

Not implemented yet.

Specified by:

getDatabase in interface Implementation

Specified by:

getDatabase in interface RasImplementationInterface

Parameters:

obj - The object.

Returns:

The Database that contains the object.

openDB

public void openDB(String name,
 int accessMode)
            throws ODMGException,
ODMGRuntimeException

Open database

Specified by:

openDB in interface RasImplementationInterface

Throws:

ODMGException

ODMGRuntimeException

closeDB

public void closeDB()
             throws ODMGException

Closes an open database. At the moment, only one database can be open at a given time and thus no parameter "database" is necessary here.

Specified by:

closeDB in interface RasImplementationInterface

Throws:

ODMGException

beginTA

public void beginTA()

Begin a transaction.

Specified by:

beginTA in interface RasImplementationInterface

isOpenTA

public boolean isOpenTA()

Returns TRUE if a transaction is currently open. This method MUST be sincere in that it asks the server about its state! (some apps use it to override timeout)

Specified by:

isOpenTA in interface RasImplementationInterface

commitTA

public void commitTA()

Commit a transaction.

Specified by:

commitTA in interface RasImplementationInterface

abortTA

public void abortTA()

Abort a transaction.

Specified by:

abortTA in interface RasImplementationInterface

setMaxRetry

public void setMaxRetry(int newRetry)

Set the maximum retry parameter

Specified by:

setMaxRetry in interface RasImplementationInterface

getMaxRetry

public int getMaxRetry()

Get the maximum retry parameter

Specified by:

getMaxRetry in interface RasImplementationInterface

getFreeServer

public void getFreeServer()
                   throws RasQueryExecutionFailedException,
RasConnectionFailedException

Requests a free server and retry's

Throws:

RasQueryExecutionFailedException

RasConnectionFailedException

queryRequest

public Object queryRequest(String parameters)
                    throws RasQueryExecutionFailedException

Specified by:

queryRequest in interface RasImplementationInterface

Throws:

RasQueryExecutionFailedException

getTypeStructure

public String getTypeStructure(String typename,
 int typetype)

Specified by:

getTypeStructure in interface RasImplementationInterface

getResultCode

public int getResultCode(BufferedReader ds)
                  throws IOException

Throws:

IOException

getBodyLine

public String getBodyLine(BufferedReader ds)
                   throws IOException

Throws:

IOException

setUserIdentification

public void setUserIdentification(String userName,
 String plainPass)

Specified by:

setUserIdentification in interface RasImplementationInterface

setUserIdentificationHashed

public void setUserIdentificationHashed(String userName,
 String passwordMD5Hash)

Specified by:

setUserIdentificationHashed in interface RasImplementationInterface

connectClient

public void connectClient(String userName,
 String passwordHash)

Specified by:

connectClient in interface RasImplementationInterface

disconnectClient

public void disconnectClient()

Specified by:

disconnectClient in interface RasImplementationInterface