er.distribution.client

Class ERClientApplication

java.lang.Object

er.distribution.client.ERClientApplication

public abstract class ERClientApplication
extends Object

Constructor Summary

Constructors

Constructor and Description
ERClientApplication()

Method Summary

Modifier and Type	Method and Description
protected void	connectToServer()
ERDistributedObjectStore	distributedObjectStore()
IOException	distributionChannelShouldThrowIOException(com.webobjects.eodistribution.client.EODistributionChannel channel, IOException ioException) EODistributionChannel.Delegate Gives the delegate an opportunity to handle an I/O exception which occurred while communicating with the server.
Throwable	distributionChannelShouldThrowServerException(com.webobjects.eodistribution.client.EODistributionChannel channel, Throwable clientExceptionForServerException, String originalServerExceptionClassName, String originalServerExceptionMessage) EODistributionChannel.Delegate Gives the delegate an opportunity to handle an exception that occurred on the server side.
void	handleLostServerConnectionException(LostServerConnectionException e)
protected abstract void	handleMissingSession(IOException e) Session timed out or server restarted. You could show a message like: "Your session has timed out.
protected abstract void	handleNoInstanceAvailable(IOException e) Should show a message and exit the app.
protected abstract String	modelPackageName() Should return the name of the package where your EOEnterpriseObject classes are located
protected void	registerClassDescriptions(NSArray<com.webobjects.eocontrol.EOClassDescription> classDescriptions) Note: assumes your entity names and your classes' simple-names are the same.
Preferences	userDefaults()

Methods inherited from class java.lang.Object

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

Constructor Detail

ERClientApplication

public ERClientApplication()

Method Detail

connectToServer

protected void connectToServer()

modelPackageName

protected abstract String modelPackageName()

Should return the name of the package where your EOEnterpriseObject classes are located

Returns:

the name of the package

registerClassDescriptions

protected void registerClassDescriptions(NSArray<com.webobjects.eocontrol.EOClassDescription> classDescriptions)

Note: assumes your entity names and your classes' simple-names are the same.

Parameters:

classDescriptions -

distributedObjectStore

public ERDistributedObjectStore distributedObjectStore()

userDefaults

public Preferences userDefaults()

distributionChannelShouldThrowIOException

public IOException distributionChannelShouldThrowIOException(com.webobjects.eodistribution.client.EODistributionChannel channel,
                                                             IOException ioException)

EODistributionChannel.Delegate Gives the delegate an opportunity to handle an I/O exception which occurred while communicating with the server. The delegate can try to handle the exception and return a new one or null if it is able to deal with the exception completely. If the delegate does not want to handle the exception, it should return the exception passed as the ioException argument (which is the exception the client throws if the delegate does not implement this method or the method is not set).

handleLostServerConnectionException

public void handleLostServerConnectionException(LostServerConnectionException e)

handleNoInstanceAvailable

protected abstract void handleNoInstanceAvailable(IOException e)

Should show a message and exit the app.

Parameters:

e -

handleMissingSession

protected abstract void handleMissingSession(IOException e)

Session timed out or server restarted.
You could show a message like: "Your session has timed out. The application will restart." And then restart the app.

Parameters:

e -

distributionChannelShouldThrowServerException

public Throwable distributionChannelShouldThrowServerException(com.webobjects.eodistribution.client.EODistributionChannel channel,
                                                               Throwable clientExceptionForServerException,
                                                               String originalServerExceptionClassName,
                                                               String originalServerExceptionMessage)

EODistributionChannel.Delegate Gives the delegate an opportunity to handle an exception that occurred on the server side. The delegate can try to handle the exception and return a new one or null if it is able to deal with the exception completely. If the delegate does not want to handle the exception, it should return the exception passed as the clientExceptionForServerException argument (which is the exception the client throws if the delegate does not implement this method or the method is not set).