com.goldencode.p2j.util

Class DeferredProgramWrapper

java.lang.Object

com.goldencode.p2j.util.TransparentWrapper

com.goldencode.p2j.util.ExternalProgramWrapper

com.goldencode.p2j.util.DeferredProgramWrapper

All Implemented Interfaces:

ADMData, AsyncRequestCountAttribute, CallbackProcedure, CommonFile, CommonHandle, CommonHandleChain, CommonProcedure, DeferredDeletable, Deletable, InstantiatingProcedure, MultiDeletable, Nameable, PersistableProcedure, PersistentProcedure, Remotable, UniqueID, WrappedResource

public class DeferredProgramWrapper
extends ExternalProgramWrapper

This program represents the instance used to assign to a handle, when a statement like RUN ... {SINGLETON|SINGLE-RUN} SET h is executed.

This saves a DeferredProgram instance, with the details of the program to be ran, when one if its internal-entries (or methods, for legacy classes) is accessed.

Field Summary

Fields inherited from class com.goldencode.p2j.util.ExternalProgramWrapper

pm

Fields inherited from class com.goldencode.p2j.util.TransparentWrapper

referent

Constructor Summary

Constructors

Constructor and Description
DeferredProgramWrapper(DeferredProgram deferred) Create a new wrapper.

Method Summary

Modifier and Type	Method and Description
logical	addSuperProcedure(handle h) Add the given handle as a super-procedure for the current handle.
logical	addSuperProcedure(handle h, int mode) Add the given handle as a super-procedure for the current handle, using the search-mode set as a string (one of the SEARCH-TARGET or SEARCH-SELF string literals).
logical	addSuperProcedure(handle h, integer mode) Add the given handle as a super-procedure for the current handle, using the search-mode set as a string (one of the SEARCH-TARGET or SEARCH-SELF string literals).
logical	addSuperProcedure(handle h, ProcedureManager.SearchMode mode) Add the given handle as a super-procedure for the current handle, using the explicit mode.
void	delete() Perform actual delete of this procedure, by calling ProcedureManager.delete(Object, boolean).
handle	getNextSibling() Get the NEXT-SIBLING attribute of this instance.
handle	getPrevSibling() Get the PREV-SIBLING attribute of this instance.
character	getPublishedEvents() Get the named events published by this procedure.
character	getSignature(character internalEntry) Execute the GET-SIGNATURE method of this instance.
boolean	handleMultipleDeletes() A deferred program wrapper is eligible for multiple deletes only if there is no server instance.
character	internalEntries() Get the INTERNAL-ENTRIES attribute of this instance.
logical	isPersistent() Get the persistent attribute of this instance.
logical	isProxy() Indicates if the procedure is a proxy procedure.
logical	removeSuperProcedure(handle h) Remove the given handle from this handle's list of super-procedures.
character	superProcedures() Get the SUPER-PROCEDURES attribute of this instance.

Methods inherited from class com.goldencode.p2j.util.ExternalProgramWrapper

applyCallback, currentWindow, deferredDelete, getADMData, getAsyncRequestCount, getCallbackProcContext, getCallbackProcName, getFileName, getPrivateData, getServerHandle, getSignature, getTransaction, getUniqueID, initFileInfo, initFileInfo, instantiatingProcedure, isRemote, isSingleRun, isSingleton, name, name, name, readOnlyError, readOnlyError, resourceType, setADMData, setADMData, setCallback, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCurrentWindow, setCurrentWindow, setPrivateData, setPrivateData, valid

Methods inherited from class com.goldencode.p2j.util.TransparentWrapper

equals, get, hashCode, id, id, set, unknown

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.goldencode.p2j.util.CallbackProcedure

applyCallback, getCallbackProcContext, getCallbackProcName, setCallback, setCallback, setCallback, setCallback, setCallback, setCallback

Methods inherited from interface com.goldencode.p2j.util.WrappedResource

id, id, unknown

Methods inherited from interface com.goldencode.p2j.util.PersistableProcedure

setPersistent, setPersistent

Methods inherited from interface com.goldencode.p2j.util.Remotable

setServerHandle

Methods inherited from interface com.goldencode.p2j.util.Deletable

allowDelete

Constructor Detail

DeferredProgramWrapper

public DeferredProgramWrapper(DeferredProgram deferred)

Create a new wrapper.

Parameters:

deferred - The configuration to defer this invocation.

Method Detail

isPersistent

public logical isPersistent()

Get the persistent attribute of this instance.

Specified by:

isPersistent in interface PersistableProcedure

Overrides:

isPersistent in class ExternalProgramWrapper

Returns:

Always false.

internalEntries

public character internalEntries()

Get the INTERNAL-ENTRIES attribute of this instance.

Specified by:

internalEntries in interface PersistentProcedure

Overrides:

internalEntries in class ExternalProgramWrapper

Returns:

Always empty string.

getSignature

public character getSignature(character internalEntry)

Execute the GET-SIGNATURE method of this instance.

Specified by:

getSignature in interface PersistentProcedure

Overrides:

getSignature in class ExternalProgramWrapper

Parameters:

internalEntry - The legacy name of the internal-entry for which the signature is needed.

Returns:

Always empty string.

superProcedures

public character superProcedures()

Get the SUPER-PROCEDURES attribute of this instance.

Specified by:

superProcedures in interface CommonProcedure

Overrides:

superProcedures in class ExternalProgramWrapper

Returns:

Always empty string.

addSuperProcedure

public logical addSuperProcedure(handle h)

Add the given handle as a super-procedure for the current handle.

Specified by:

addSuperProcedure in interface CommonProcedure

Overrides:

addSuperProcedure in class ExternalProgramWrapper

Parameters:

h - The handle to be added as a super-procedure.

Returns:

Always false.

addSuperProcedure

public logical addSuperProcedure(handle h,
                                 ProcedureManager.SearchMode mode)

Add the given handle as a super-procedure for the current handle, using the explicit mode.

Specified by:

addSuperProcedure in interface CommonProcedure

Overrides:

addSuperProcedure in class ExternalProgramWrapper

Parameters:

h - The handle to be added as a super-procedure.

mode - The ProcedureManager.SearchMode to be set for the h handle.

Returns:

Always false.

addSuperProcedure

public logical addSuperProcedure(handle h,
                                 int mode)

Add the given handle as a super-procedure for the current handle, using the search-mode set as a string (one of the SEARCH-TARGET or SEARCH-SELF string literals).

Specified by:

addSuperProcedure in interface CommonProcedure

Overrides:

addSuperProcedure in class ExternalProgramWrapper

Parameters:

h - The handle to be added as a super-procedure.

mode - The search-mode to be set for the h handle.

Returns:

Always false.

addSuperProcedure

public logical addSuperProcedure(handle h,
                                 integer mode)

Add the given handle as a super-procedure for the current handle, using the search-mode set as a string (one of the SEARCH-TARGET or SEARCH-SELF string literals).

Specified by:

addSuperProcedure in interface CommonProcedure

Overrides:

addSuperProcedure in class ExternalProgramWrapper

Parameters:

h - The handle to be added as a super-procedure.

mode - The search-mode to be set for the h handle.

Returns:

Always false.

removeSuperProcedure

public logical removeSuperProcedure(handle h)

Remove the given handle from this handle's list of super-procedures.

Specified by:

removeSuperProcedure in interface CommonProcedure

Overrides:

removeSuperProcedure in class ExternalProgramWrapper

Parameters:

h - The procedure handle to be removed.

Returns:

Always false.

isProxy

public logical isProxy()

Indicates if the procedure is a proxy procedure.

Specified by:

isProxy in interface PersistentProcedure

Overrides:

isProxy in class ExternalProgramWrapper

Returns:

always true

getPublishedEvents

public character getPublishedEvents()

Get the named events published by this procedure.

Specified by:

getPublishedEvents in interface PersistentProcedure

Overrides:

getPublishedEvents in class ExternalProgramWrapper

Returns:

Always empty string.

getNextSibling

public handle getNextSibling()

Get the NEXT-SIBLING attribute of this instance.

Specified by:

getNextSibling in interface CommonHandleChain

Overrides:

getNextSibling in class ExternalProgramWrapper

Returns:

Always an unknown value.

getPrevSibling

public handle getPrevSibling()

Get the PREV-SIBLING attribute of this instance.

Specified by:

getPrevSibling in interface CommonHandleChain

Overrides:

getPrevSibling in class ExternalProgramWrapper

Returns:

Always an unknown value.

delete

public void delete()

Perform actual delete of this procedure, by calling ProcedureManager.delete(Object, boolean).

Specified by:

delete in interface Deletable

Overrides:

delete in class ExternalProgramWrapper

handleMultipleDeletes

public boolean handleMultipleDeletes()

A deferred program wrapper is eligible for multiple deletes only if there is no server instance.

Specified by:

handleMultipleDeletes in interface MultiDeletable

Overrides:

handleMultipleDeletes in class ExternalProgramWrapper

Returns:

false if this can't handle an invalid delete or true otherwise.