com.goldencode.p2j.util

Interface CommonHandle

All Superinterfaces:

WrappedResource

All Known Subinterfaces:

AsyncRequest, ButtonList, ButtonListGroup, ButtonListGroupItem, Calendar, Clipboard, ColorTableResource, CommonAuditControl, CommonAuditPolicy, CommonErrorStatus, CommonFileInfo, CommonHandleChain, CommonLastEvent, CommonListWidget<T>, CommonSecurityPolicy, CommonSession, CommonWidget, Compiler, ControlFrame, DebuggerResource, FontTableResource, Group, HandleCommon, LegacyDsLogManager, LegacyLogManager, PersistentProcedure, Profiler, RcodeInfo, Server, Socket, SocketListener, TempTable

All Known Implementing Classes:

AbstractTempTable, AsyncRequestImpl, BaseEntity, BrowseColumnWidget, BrowseWidget, BufferFieldImpl, BufferImpl, ButtonListGroupItemWidget, ButtonListGroupWidget, ButtonListWidget, ButtonWidget, CalendarWidget, Call, ChartWidget, ClientPrincipal, ComboBoxWidget, ControlEntity, ControlEntityExt, ControlFrameWidget, ControlSetEntity, ControlTextWidget, DataRelation, DataSet, DataSource, DeferredProgramWrapper, EditorWidget, ExternalProgramWrapper, FieldGroup, FillInWidget, FrameWidget, GenericWidget, HandleChain, HandleResource, HtmlBrowserWidget, ImageListWidget, ImageWidget, LegacyDsLogManagerImpl, LegacyLogManagerImpl, LiteralWidget, MenuContainerWidget, MenuItemWidget, MenuWidget, ObjectResource, PaneEntity, PortTypeWrapper, ProgressBarWidget, ProxyProcedureWrapper, QueryWrapper, RadioSetWidget, RectangleWidget, SaxAttributesImpl, SaxEntityImpl, SaxReaderImpl, SaxWriterImpl, SelectionListWidget, SensitiveResource, ServerImpl, SignatureWidget, SkipEntity, SliderWidget, SOAPFaultDetailImpl, SOAPFaultImpl, SOAPHeaderEntryImpl, SOAPHeaderImpl, SocketImpl, SocketListenerImpl, SpreadsheetWidget, StaticDataSet, StaticTempTable, SubMenuWidget, TabSetWidget, TempTableBuilder, TextBasedWidget, TextWidget, ToggleBoxWidget, TransactionImpl, TreeListNodeResource, TreeListWidget, TreeNodeCollectionResource, TreeNodeResource, TreeViewNodeResource, TreeViewWidget, TreeWidgetBase, WindowWidget, XCommonImpl, XDocumentImpl, XEntityImpl, XNodeRefImpl

public interface CommonHandle
extends WrappedResource

Exposes the following methods or attributes, common for all handles:

attribute or method	API
TYPE	resourceType()

The readOnlyError(String) API is emitted only in cases when the conversion rules decide that the given attribute is used on the right side of an assignment, but that attribute is read-only.

Method Summary

Modifier and Type	Method and Description
void	readOnlyError(java.lang.String attribute) Deprecated. Use the overloaded method with multiple arguments. This API is deprecated because of two reasons: first, it looses the possible side effect of the assigned expression (consider the case when it is a function or method, but not exclusively). Secondly, some (if not all) are unknown value sensitive, meaning that, prior testing whether this is a writable attribute, P4GL checks first if the expression is unknown and if this value is supported. In this case a different error condition is raised.
void	readOnlyError(java.lang.String attribute, java.lang.Object expr) Shows a specific error, as this read-only attribute was used on the right-side of an assignment.
character	resourceType() Get the type of this handle.

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

id, id, unknown, valid

Method Detail

resourceType

character resourceType()

Get the type of this handle.

Returns:

See above.

readOnlyError

@Deprecated
void readOnlyError(java.lang.String attribute)

Deprecated. Use the overloaded method with multiple arguments.

This API is deprecated because of two reasons: first, it looses the possible side effect of the assigned expression (consider the case when it is a function or method, but not exclusively). Secondly, some (if not all) are unknown value sensitive, meaning that, prior testing whether this is a writable attribute, P4GL checks first if the expression is unknown and if this value is supported. In this case a different error condition is raised.

Show a specific error, as this read-only attribute was used on the right-side of an assignment.

Parameters:

attribute - The read-only attribute.

readOnlyError

void readOnlyError(java.lang.String attribute,
                   java.lang.Object expr)

Shows a specific error, as this read-only attribute was used on the right-side of an assignment. If the expr is evaluated to ? (unknown value) and this attribute does not support it, a specific error is raised.

Parameters:

attribute - The read-only attribute.

expr - The expression whose value was attempted to be assigned to READ-ONLY attribute.