com.portal.bas

Class PInfranetConnectionImpl

java.lang.Object

com.portal.bas.PInfranetAppControllerImpl

com.portal.bas.PInfranetConnectionImpl

All Implemented Interfaces:

PInfranetAppController, PInfranetConnection, CMConnectionListener, Remote

Deprecated.

As of Release 6.1, PInfranetConnectionImpl is deprecated and replaced by PInfranetAppController and PCachedContext.

public class PInfranetConnectionImpl
extends PInfranetAppControllerImpl

PInfranetConnectionImpl is the implementation portion of the PInfranetConnection distributed class. This class is imposed between the client application and a PortalContext so that the model cache may be consulted prior to reads, and updated properly after writes.

Version:

20.1.2

Author:

Larry Lynch-Freshner

Field Summary

Fields inherited from class com.portal.bas.PInfranetAppControllerImpl

mCompMap

Constructor Summary

Constructors

Constructor and Description
PInfranetConnectionImpl() Deprecated. Constructs an instance of PInfranetConnectionImpl from the login information stored in PortalUser.properties.
PInfranetConnectionImpl(PInfranetConnectionImpl conn) Deprecated. Constructs an instance of PInfranetConnectionImpl from another connection.
PInfranetConnectionImpl(String name, String password, String connectInfo) Deprecated. Constructs an instance of PInfranetConnectionImpl from login information.

Method Summary

Modifier and Type	Method and Description
void	abortTransaction() Deprecated. Halts an Portal transaction and rolls back the logs.
FList	callOpcode(int opcode, FList in) Deprecated. Given an input flist, calls an opcode with a default value of "0" for the opcode flags.
FList	callOpcode(int opcode, FList in, int flags) Deprecated. Given an input flist, calls an opcode, using the opcode flag values passed in.
FList	callOpcode(int opcode, PModelHandle in) Deprecated. Given an input flist model, calls an opcode with a default value of "0" for the opcode flags.
FList	callOpcode(int opcode, PModelHandle in, int flags) Deprecated. Given an input flist model, calls an opcode, using the opcode flag values passed in.
void	commitTransaction() Deprecated. Commits an Portal transaction.
PModelHandle	createModelFrom(FList fl) Deprecated. Creates a new model handle from an flist, and sets that flist in the cache.
PModelHandle	createModelFrom(Poid pd) Deprecated. Creates a new model handle from a Poid.
PModelHandle	createModelFrom(SparseArray sa) Deprecated. Creates a new model handle from a SparseArray.
void	discardModel(PModelHandle mh) Deprecated. Removes a model from the cache to free resources.
long	getCurrentDB() Deprecated. Returns the database number that this context is connected to.
Object	getField(FList list, PDataFieldSpecification spec) Deprecated. Gets a field from an flist.
Object	getField(PModelHandle mh, PDataFieldSpecification spec) Deprecated. Gets a field from a model.
Object	getModelField(FList data, PFieldSpecification spec) Deprecated. Gets a field from an flist.
Object	getModelField(PModelHandle data, PFieldSpecification spec) Deprecated. Gets a field from a model.
PModelHandle	getOrCreateModelFrom(FList fl) Deprecated. Creates a model for the specified flist, but does not put the flist in the cache unless there is no match for the newly-created model handle.
Poid	getUserID() Deprecated. Returns the current userid.
FList	getWholeObject(PModelHandle mh) Deprecated. Forces the cache to be loaded with an entire storable class for a given model handle.
void	logCache() Deprecated. Serves as a debug function to dump the cache to the log file.
PComponentControllerImpl	lookupController(PRemoteComponent comp) Deprecated. Looks up a controller for a given component.
Object	lookupModel(PModelHandle modl) Deprecated. Gets the model from the cache for a model handle.
Poid	lookupPoid(PModelHandle modl) Deprecated. Gets the POID from the cache for a model handle.
void	openTransaction(int flags) Deprecated. Opens an Portal transaction.
void	registerComponent(PRemoteComponent comp, String controllerClass) Deprecated. Registers the client portion of a component with the Portal server.
PModelHandle[]	search(int opcode, FList in) Deprecated. Calls the search opcode, but returns an array of model handles.
void	setField(FList list, PDataFieldSpecification spec, Object val) Deprecated. Sets a field in an flist.
void	setField(PModelHandle modl, PDataFieldSpecification spec, Object val) Deprecated. Sets a field in a model.
void	setModel(PModelHandle modl, FList fl) Deprecated. Sets an flist model in the cache and associates it with a handle.
void	setModel(PModelHandle modl, Poid pd) Deprecated. Sets a POID model in the cache and associates it with a handle.
void	setModel(PModelHandle modl, SparseArray sa) Deprecated. Sets a SparseArray model in the cache and associates it with a handle.
void	unregisterComponent(PRemoteComponent comp) Deprecated. Unregisters the client portion of a component with the Portal server.

Methods inherited from class com.portal.bas.PInfranetAppControllerImpl

close, cmreconnected, createController, createNewModel, duplicate, duplicate, getAccountHandle, getAppName, getClientLocale, getConnection, getContext, getEventListener, getModelField, getOtherData, getPermissionFor, getPermissions, getRestrictionOn, getServiceHandle, getUserPreferences, isBrandingEnabled, login, lookupController, postEventListener, registerApp, registerController, releaseConnection, releaseContext, removeEventListener, saveUserPreferences, setBrandContext, setConnection, setModelField, setUserPreferences, storeUserPrefs, throwInfranetException, unregisterController, unregisterControllers, unsetBrandContext, verifyAndSwitchToUser

Methods inherited from class java.lang.Object

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

Constructor Detail

PInfranetConnectionImpl

public PInfranetConnectionImpl()
                        throws RemoteException

Deprecated.

Constructs an instance of PInfranetConnectionImpl from the login information stored in PortalUser.properties.

Throws:

RemoteException - thrown for errors

PInfranetConnectionImpl

public PInfranetConnectionImpl(String name,
                               String password,
                               String connectInfo)
                        throws RemoteException

Deprecated.

Constructs an instance of PInfranetConnectionImpl from login information.

Parameters:

name - the user's login name

password - the user's password

connectInfo - the hostname and port

Throws:

RemoteException - thrown for errors

PInfranetConnectionImpl

public PInfranetConnectionImpl(PInfranetConnectionImpl conn)
                        throws RemoteException

Deprecated.

Constructs an instance of PInfranetConnectionImpl from another connection. This creates a separate connection that shares a cache with the specified connection. Use this constructor when you need a separate connection, for example, to use for long step searches.

Parameters:

conn - the existing connection

Throws:

RemoteException - thrown for errors

Method Detail

callOpcode

public FList callOpcode(int opcode,
                        FList in)
                 throws RemoteException,
                        EBufException

Deprecated.

Given an input flist, calls an opcode with a default value of "0" for the opcode flags.

Parameters:

opcode - the opcode to call

in - the input flist

Returns:

The output flist model.

Throws:

EBufException - thrown for Portal errors

RemoteException - thrown for remote errors

callOpcode

public FList callOpcode(int opcode,
                        PModelHandle in)
                 throws RemoteException,
                        EBufException

Deprecated.

Given an input flist model, calls an opcode with a default value of "0" for the opcode flags.

Parameters:

opcode - the opcode to call

in - the input flist model

Returns:

The output flist model.

Throws:

EBufException - thrown for Portal errors

RemoteException - thrown for remote errors

callOpcode

public FList callOpcode(int opcode,
                        PModelHandle in,
                        int flags)
                 throws RemoteException,
                        EBufException

Deprecated.

Given an input flist model, calls an opcode, using the opcode flag values passed in.

Parameters:

opcode - the opcode to call

in - the input flist model

flags - the opcode flags

Returns:

The output flist model.

Throws:

EBufException - thrown for Portal errors

RemoteException - thrown for remote errors

callOpcode

public FList callOpcode(int opcode,
                        FList in,
                        int flags)
                 throws RemoteException,
                        EBufException

Deprecated.

Given an input flist, calls an opcode, using the opcode flag values passed in.

Parameters:

opcode - the opcode to call

in - the input flist

flags - the opcode flags

Returns:

The output flist model.

Throws:

EBufException - thrown for Portal errors

RemoteException - thrown for remote errors

search

public PModelHandle[] search(int opcode,
                             FList in)
                      throws RemoteException,
                             EBufException

Deprecated.

Calls the search opcode, but returns an array of model handles.

Parameters:

opcode - an Portal search opcode (SEARCH, STEP_SEARCH, STEP_NEXT)

in - the input flist

Returns:

An array of model handles.

Throws:

EBufException - thrown for Portal errors

RemoteException - thrown for remote errors

openTransaction

public void openTransaction(int flags)
                     throws RemoteException

Deprecated.

Opens an Portal transaction.

Parameters:

flags - the transaction flags

Throws:

RemoteException - thrown for remote errors

abortTransaction

public void abortTransaction()
                      throws RemoteException

Deprecated.

Halts an Portal transaction and rolls back the logs.

Throws:

RemoteException - thrown for remote errors

commitTransaction

public void commitTransaction()
                       throws RemoteException

Deprecated.

Commits an Portal transaction.

Throws:

RemoteException - thrown for remote errors

getUserID

public Poid getUserID()
               throws RemoteException

Deprecated.

Returns the current userid.

Returns:

The userid POID.

Throws:

RemoteException - thrown for errors

getCurrentDB

public long getCurrentDB()
                  throws RemoteException

Deprecated.

Returns the database number that this context is connected to.

Returns:

The current database number.

Throws:

RemoteException - thrown for errors

registerComponent

public void registerComponent(PRemoteComponent comp,
                              String controllerClass)
                       throws RemoteException

Deprecated.

Registers the client portion of a component with the Portal server.

Specified by:

registerComponent in interface PInfranetConnection

Overrides:

registerComponent in class PInfranetAppControllerImpl

Parameters:

comp - the remote component to register

controllerClass - the class name of the component controller

Throws:

RemoteException - thrown in case of failure

unregisterComponent

public void unregisterComponent(PRemoteComponent comp)
                         throws RemoteException

Deprecated.

Unregisters the client portion of a component with the Portal server.

Specified by:

unregisterComponent in interface PInfranetConnection

Overrides:

unregisterComponent in class PInfranetAppControllerImpl

Parameters:

comp - the remote component to unregister

Throws:

RemoteException - thrown for errors

lookupController

public PComponentControllerImpl lookupController(PRemoteComponent comp)

Deprecated.

Looks up a controller for a given component.

Parameters:

comp - a PRemoteComponent component stub

Returns:

The controller, if any, associated with the component.

getOrCreateModelFrom

public PModelHandle getOrCreateModelFrom(FList fl)
                                  throws RemoteException

Deprecated.

Creates a model for the specified flist, but does not put the flist in the cache unless there is no match for the newly-created model handle.

Parameters:

fl - the model to create a handle for

Returns:

A new model handle.

Throws:

RemoteException - thrown for errors

createModelFrom

public PModelHandle createModelFrom(FList fl)
                             throws RemoteException

Deprecated.

Creates a new model handle from an flist, and sets that flist in the cache.

Parameters:

fl - the model to create a handle from

Returns:

A new model handle.

Throws:

RemoteException - thrown for errors

createModelFrom

public PModelHandle createModelFrom(SparseArray sa)
                             throws RemoteException

Deprecated.

Creates a new model handle from a SparseArray.

Parameters:

sa - the model to create a handle from

Returns:

A new model handle.

Throws:

RemoteException - thrown for errors

createModelFrom

public PModelHandle createModelFrom(Poid pd)
                             throws RemoteException

Deprecated.

Creates a new model handle from a Poid.

Parameters:

pd - the model to create a handle from

Returns:

A new model handle.

Throws:

RemoteException - thrown for errors

lookupPoid

public Poid lookupPoid(PModelHandle modl)
                throws RemoteException,
                       EBufException

Deprecated.

Gets the POID from the cache for a model handle.

Parameters:

modl - the model handle to look up

Returns:

The model's POID.

Throws:

EBufException - thrown for Portal errors

RemoteException - thrown for remote errors

lookupModel

public Object lookupModel(PModelHandle modl)
                   throws RemoteException,
                          EBufException

Deprecated.

Gets the model from the cache for a model handle.

Parameters:

modl - the model handle to look up

Returns:

An Object, which is either an flist, a SparseArray, or a POID.

Throws:

EBufException - thrown for Portal errors

RemoteException - thrown for remote errors

setModel

public void setModel(PModelHandle modl,
                     FList fl)
              throws RemoteException

Deprecated.

Sets an flist model in the cache and associates it with a handle.

Parameters:

modl - the model handle to use as a key

fl - the flist model to store

Throws:

RemoteException - thrown for errors

setModel

public void setModel(PModelHandle modl,
                     SparseArray sa)
              throws RemoteException

Deprecated.

Sets a SparseArray model in the cache and associates it with a handle.

Parameters:

modl - the model handle to use as a key

sa - the SparseArray model to store

Throws:

RemoteException - thrown for errors

setModel

public void setModel(PModelHandle modl,
                     Poid pd)
              throws RemoteException

Deprecated.

Sets a POID model in the cache and associates it with a handle.

Parameters:

modl - the POID's model handle to use as a key

pd - the POID model to store

Throws:

RemoteException - thrown for errors

discardModel

public void discardModel(PModelHandle mh)
                  throws RemoteException

Deprecated.

Removes a model from the cache to free resources.

Parameters:

mh - a model handle

Throws:

RemoteException - thrown for errors

getModelField

public Object getModelField(FList data,
                            PFieldSpecification spec)
                     throws RemoteException

Deprecated.

Gets a field from an flist. This version only returns a model handle for a field that is itself a model. Use this method when the returned field data will be sent to the client. In the case of compound specifications, an object array is returned.

Parameters:

data - the model to get a field from

spec - a specification for which field(s) to get

Returns:

The contents of the field, in the form of an Integer, BigDecimal, Date, Double, byte array, String, or ModelHandle.

Throws:

RemoteException - thrown for errors

getModelField

public Object getModelField(PModelHandle data,
                            PFieldSpecification spec)
                     throws RemoteException

Deprecated.

Gets a field from a model. This version returns a model handle only for a field that is itself a model. Use this method when the returned field data will be sent to the client. In the case of compound specifications, an object array is returned.

Parameters:

data - the model to get a field from

spec - a specification for which field(s) to get

Returns:

The contents of the field, in the form of an Integer, BigDecimal, Date, Double, byte array, String, or ModelHandle.

Throws:

RemoteException - thrown for errors

getWholeObject

public FList getWholeObject(PModelHandle mh)
                     throws RemoteException,
                            EBufException

Deprecated.

Forces the cache to be loaded with an entire storable class for a given model handle. Called when the caller knows it will access more than a field or two.

Parameters:

mh - a model handle

Returns:

An Flist object.

Throws:

EBufException - thrown for Portal errors

RemoteException - thrown for remote errors

getField

public Object getField(FList list,
                       PDataFieldSpecification spec)
                throws RemoteException

Deprecated.

Gets a field from an flist.

Parameters:

list - the flist to get a field from

spec - a specification of which field to get

Returns:

The field's value.

Throws:

RemoteException - thrown for errors

getField

public Object getField(PModelHandle mh,
                       PDataFieldSpecification spec)
                throws RemoteException

Deprecated.

Gets a field from a model.

Parameters:

mh - the model handle to get a field from

spec - a specification of which field to get

Returns:

The field's value.

Throws:

RemoteException - thrown for errors

setField

public void setField(PModelHandle modl,
                     PDataFieldSpecification spec,
                     Object val)
              throws RemoteException

Deprecated.

Sets a field in a model.

Parameters:

modl - the model to set a field in

spec - a specification of which field to set

val - the new value to set

Throws:

RemoteException - thrown for errors

setField

public void setField(FList list,
                     PDataFieldSpecification spec,
                     Object val)
              throws RemoteException

Deprecated.

Sets a field in an flist.

Parameters:

list - the flist to set a field in

spec - a specification of which field to set

val - the new value to set

Throws:

RemoteException - thrown for errors

logCache

public void logCache()

Deprecated.

Serves as a debug function to dump the cache to the log file.