biouml.modules.genenet.access
Class MGL_Connection_Client

biouml.modules.genenet.access.MGL_Connection
  |
  +--biouml.modules.genenet.access.MGL_Connection_Client

public class MGL_Connection_Client

extends MGL_Connection

Provides access to the MGL server. The application (applet) should has only one MGL_ConnectionClient.

To provide more rapid access to the MGL server application can open the session using the function openSession While the session is opened, the connection (socket) is not closed, when disconnect function is called.

closeSession close the session, if the _sessionLevel = 0.

close close the session in any case.

Example:

MGL_ConectionClient connection = new MGL_ConnectionClient();
try
{
connection.openSession();               // _sessionLevel = 1
connection.openSession();           // _sessionLevel = 2
connection.connect();              // open the connection
...
connection.disconnect()         // do nothing, because _sessionLevel > 0
connection.closeSession();          // _sessionLevel = 1
connection.closeSession();              // _sessionLevel = 0, close the connection
}
finally()
{
connection.close();                     // close the connection in any case
// _sessionLevel = 0
}

Version: 2.4.6, 28 March 2000

Constructor Summary

MGL_Connection_Client(String address, String dbCurrent)           Constructs the MGL_Connection_Client with specified database NAME for transfer and text panel to display prompts.

MGL_Connection_Client(String address)           Constructs the MGL_Connection_Client with text panel to display prompts.

Method Summary
void	close()           Closes the connection in any case.
void	closeSession()           Closes the session.
void	connect()           Opens the connection with the MGL server.
void	disconnect()           Close the connection.
String	getDatabaseDescription()           Returns the current database description.
String	getDatabaseList()           Returns a list of database NAMEs loaded on the MGL server.
String	getDefaultFieldsDescription()           Returns default fields description.
String	getEntriesSetByAC(String ac)           Returns the set of required entries by their accession numbers.
String	getEntriesSetByID(String id)           Returns the set of required entries by their identifiers.
String	getEntryByAC(String ac)           Returns the required entry by its accession number.
String	getEntryByID(String id)           Returns the required entry by its identifcator.
DataInputStream	getGeneNetDescription()           Recieves the GeneNet database description.
DataInputStream	getGeneNetListID()           Recieves the lists of identifiers for all tables from the GeneNet database description.
DataInputStream	getGeneNetScheme(String id)           Recieves the GeneNet scheme by its identifier and all entries listed in it.
List	getListID()           Returns the list of identificators for all entries in current database.
int	getSize()           Returns the number of entries in the database.
void	openSession()           Opens the session.
String	removeEntry(String id)           Removes the required entry by its identifcator.
synchronized String	request(int command, String argument, boolean readAnswer)           Opens the connection with the MGL server, sends request, reads the answer, check it, and close the connection.
synchronized String	request(int command, String dbName, String argument, boolean readAnswer)
void	setDatabase(String dbName)           Set up for data transfer the required database.
void	writeEntriesSet(String entries)           Write the set of entries.
void	writeEntry(String entry)           Write the entry.

Methods inherited from class biouml.modules.genenet.access.MGL_Connection

readStringUTF, writeStringUTF

Field Detail

MGL_PORT

public final static int MGL_PORT

public MGL_Connection_Client(String address, String dbCurrent)

Constructs the MGL_Connection_Client with specified database NAME for transfer and text panel to display prompts.

Parameters:

addres - the MGL Server address

dbCurrent - database NAME for transfer

pText - text panel to display prompts

See Also:

setDatabase(java.lang.String)

public MGL_Connection_Client(String address)

Constructs the MGL_Connection_Client with text panel to display prompts.

Parameters:

addres - the MGL Server address

pText - text panel to display prompts

See Also:

setDatabase(java.lang.String)

public void close()

Closes the connection in any case.

See Also:

MGL_ConnectionClient, openSession(), closeSession()

public void closeSession()

Closes the session.

See Also:

MGL_ConnectionClient, openSession(), close()

public void connect()
              throws java.io.IOException

Opens the connection with the MGL server.

public void disconnect()

Close the connection.

See Also:

MGL_ConnectionClient, openSession(), closeSession(), close()

public String getDatabaseDescription()
                               throws java.io.IOException

Returns the current database description.

See Also:

MGL_ConnectionServer#sendDatabaseDescription, Database

public String getDatabaseList()
                        throws java.io.IOException

Returns a list of database NAMEs loaded on the MGL server.

See Also:

MGL_ConnectionServer#getDatabaseList

public String getDefaultFieldsDescription()
                                    throws java.io.IOException

Returns default fields description.

See Also:

MGL_ConnectionServer#sendDefaultFieldsDescription, Database#defaultFieldsDescription

public String getEntriesSetByAC(String ac)
                          throws java.io.IOException

Returns the set of required entries by their accession numbers.

See Also:

MGL_ConnectionServer#EntriesSetAC

public String getEntriesSetByID(String id)
                          throws java.io.IOException

Returns the set of required entries by their identifiers.

See Also:

MGL_ConnectionServer#EntriesSetByID

public String getEntryByAC(String ac)
                     throws java.io.IOException

Returns the required entry by its accession number.

See Also:

MGL_ConnectionServer#sendEntry, Database#getEntryByAC

public String getEntryByID(String id)
                     throws java.io.IOException

Returns the required entry by its identifcator.

See Also:

MGL_ConnectionServer#sendEntry, Database#getEntryByID

public DataInputStream getGeneNetDescription()
                                       throws java.io.IOException

Recieves the GeneNet database description.

See Also:

MGL_ConnectionServer#sendGeneNetDescription

public DataInputStream getGeneNetListID()
                                  throws java.io.IOException

Recieves the lists of identifiers for all tables from the GeneNet database description.

See Also:

MGL_ConnectionServer#sendGeneNetListID

public DataInputStream getGeneNetScheme(String id)
                                  throws java.io.IOException

Recieves the GeneNet scheme by its identifier and all entries listed in it.

See Also:

MGL_ConnectionServer#sendGeneNetScheme

public List getListID()
                throws java.io.IOException

Returns the list of identificators for all entries in current database.

See Also:

MGL_ConnectionServer#sendListID, Database#getListID

public int getSize()
             throws java.io.IOException

Returns the number of entries in the database.

See Also:

MGL_ConnectionServer#sendSize, Database#getSize

public void openSession()

Opens the session.

See Also:

MGL_ConnectionClient, closeSession(), close()

public String removeEntry(String id)
                    throws java.io.IOException

Removes the required entry by its identifcator.

See Also:

MGL_ConnectionServer#removeEntry, Database#removeEntry

public synchronized String request(int command, String argument, boolean readAnswer)
                             throws java.io.IOException

Opens the connection with the MGL server, sends request, reads the answer, check it, and close the connection.

Parameters:

command - request command (cod)

argument - request argument

See Also:

MGL_Connection

public synchronized String request(int command, String dbName, String argument, boolean readAnswer)
                             throws java.io.IOException

public void setDatabase(String dbName)
                  throws java.io.IOException

Set up for data transfer the required database.

Parameters:

dbNAME - dtatabase NAME used by client & server

See Also:

MGL_ConnectionServer#setDatabase, Database#getName

public void writeEntriesSet(String entries)
                      throws java.io.IOException

Write the set of entries.

See Also:

MGL_ConnectionServer#writeEntriesSet

public void writeEntry(String entry)
                 throws java.io.IOException

Write the entry.

See Also:

MGL_ConnectionServer#writeEntry

Association Links

to Class java.lang.String

The Internet address of the MGL server.

to Class java.lang.String

The database name that in current use.

to Class java.lang.String

Databases default fields description.