org.npsnet.xrti.proxies
Class HelloWorldProxyAmbassador

java.lang.Object
  org.npsnet.xrti.utilities.ProxyAmbassador
      org.npsnet.xrti.proxies.HelloWorldProxyAmbassador

All Implemented Interfaces:

FederateAmbassador

public class HelloWorldProxyAmbassador

extends ProxyAmbassador

Autogenerated proxy ambassador.

Author:

org.npsnet.xrti.utilities.ProxyCompiler

Field Summary

private ParameterHandle	Communication_messageHandle Handle for the message parameter of the Communication interaction.
private InteractionClassHandle	CommunicationHandle Handle for the Communication interaction.
private ObjectClassHandle	CountryHandle Handle for the Country object class.
private ObjectClassHandle	HLAobjectRootHandle Handle for the HLAobjectRoot object class.
private java.util.Vector	interactionListeners The list of interaction listeners.

Fields inherited from class org.npsnet.xrti.utilities.ProxyAmbassador

objectInstanceHandleProxyMap, proxyAmbassadorListeners, rtiAmbassador

Constructor Summary

HelloWorldProxyAmbassador(RTIambassador pRTIAmbassador)
Constructor.

Method Summary

void	addInteractionListener(HelloWorldInteractionListener il) Adds a listener for the interactions processed by this ambassador.
void	discoverObjectInstance(ObjectInstanceHandle theObject, ObjectClassHandle theObjectClass, java.lang.String objectName) Notifies the federate of the presence of an object instance.
CountryProxy	newCountry() Registers a new Country and returns a proxy object that may be used to examine and control its state.
CountryProxy	newCountry(java.lang.String name) Registers a new Country with the specified name and returns a proxy object that may be used to examine and control its state.
HLAobjectRootProxy	newHLAobjectRoot() Registers a new HLAobjectRoot and returns a proxy object that may be used to examine and control its state.
HLAobjectRootProxy	newHLAobjectRoot(java.lang.String name) Registers a new HLAobjectRoot with the specified name and returns a proxy object that may be used to examine and control its state.
void	publishAndSubscribeObjectClassAttributes() Publishes and subscribes all supported object class attributes.
void	receiveInteraction(InteractionClassHandle interactionClass, ParameterHandleValueMap theParameters, byte[] userSuppliedTag, OrderType sentOrdering, TransportationType theTransport) Notifies the federate of a received interaction.
void	removeInteractionListener(HelloWorldInteractionListener il) Removes a listener for the interactions processed by this ambassador.
void	sendCommunication(java.lang.String message, byte[] userSuppliedTag) A generic message.

Methods inherited from class org.npsnet.xrti.utilities.ProxyAmbassador

addProxyAmbassadorListener, announceSynchronizationPoint, attributeIsNotOwned, attributeIsOwnedByRTI, attributeOwnershipAcquisitionNotification, attributeOwnershipUnavailable, attributesInScope, attributesOutOfScope, confirmAttributeOwnershipAcquisitionCancellation, deregisterFederateAmbassador, federationNotRestored, federationNotSaved, federationRestoreBegun, federationRestored, federationRestoreStatusResponse, federationSaved, federationSaveStatusResponse, federationSynchronized, getObjectInstanceProxies, getObjectInstanceProxy, informAttributeOwnership, initiateFederateRestore, initiateFederateSave, initiateFederateSave, objectInstanceNameReservationFailed, objectInstanceNameReservationSucceded, provideAttributeValueUpdate, receiveInteraction, receiveInteraction, receiveInteraction, receiveInteraction, receiveInteraction, reflectAttributeValues, reflectAttributeValues, reflectAttributeValues, reflectAttributeValues, reflectAttributeValues, reflectAttributeValues, registerFederateAmbassador, removeObjectInstance, removeObjectInstance, removeObjectInstance, removeProxyAmbassadorListener, requestAttributeOwnershipAssumption, requestAttributeOwnershipRelease, requestDivestitureConfirmation, requestFederationRestoreFailed, requestFederationRestoreSucceeded, requestRetraction, startRegistrationForObjectClass, stopRegistrationForObjectClass, synchronizationPointRegistrationFailed, synchronizationPointRegistrationSucceeded, timeAdvanceGrant, timeConstrainedEnabled, timeRegulationEnabled, turnInteractionsOff, turnInteractionsOn, turnUpdatesOffForObjectInstance, turnUpdatesOnForObjectInstance

Methods inherited from class java.lang.Object

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

Field Detail

interactionListeners

private java.util.Vector interactionListeners

The list of interaction listeners.

CommunicationHandle

private InteractionClassHandle CommunicationHandle

Handle for the Communication interaction.

Communication_messageHandle

private ParameterHandle Communication_messageHandle

Handle for the message parameter of the Communication interaction.

HLAobjectRootHandle

private ObjectClassHandle HLAobjectRootHandle

Handle for the HLAobjectRoot object class.

CountryHandle

private ObjectClassHandle CountryHandle

Handle for the Country object class.

Constructor Detail

HelloWorldProxyAmbassador

public HelloWorldProxyAmbassador(RTIambassador pRTIAmbassador)
                          throws InvalidInteractionClassHandle,
                                 InvalidObjectClassHandle,
                                 NameNotFound,
                                 InteractionClassNotDefined,
                                 FederateServiceInvocationsAreBeingReportedViaMOM,
                                 FederateNotExecutionMember,
                                 SaveInProgress,
                                 RestoreInProgress,
                                 RTIinternalError

Constructor.

Parameters:

pRTIAmbassador - the run-time infrastructure ambassador

Throws:

InvalidInteractionClassHandle - if an interaction class handle was invalid

NameNotFound - if an interaction or parameter name was not found

InteractionClassNotDefined - if an interaction class is not defined

FederateServiceInvocationsAreBeingReportedViaMOM - if federate service invocations are being reported via the management object model

FederateNotExecutionMember - if the federate is not a member of an execution

SaveInProgress - if a save operation is in progress

RestoreInProgress - if a restore operation is in progress

RTIinternalError - if an internal error occurred in the run-time infrastructure

InvalidObjectClassHandle

Method Detail

publishAndSubscribeObjectClassAttributes

public void publishAndSubscribeObjectClassAttributes()
                                              throws InvalidObjectClassHandle,
                                                     NameNotFound,
                                                     ObjectClassNotDefined,
                                                     AttributeNotDefined,
                                                     FederateNotExecutionMember,
                                                     SaveInProgress,
                                                     RestoreInProgress,
                                                     RTIinternalError

Publishes and subscribes all supported object class attributes.

Throws:

InvalidObjectClassHandle - if an object class handle is invalid

NameNotFound - if a name is not found

ObjectClassNotDefined - if an object class is undefined

AttributeNotDefined - if an attribute is undefined

FederateNotExecutionMember - if the federate is not an execution member

SaveInProgress - if a save operation is in progress

RestoreInProgress - if a restore operation is in progress

RTIinternalError - if an internal error occurs in the run-time infrastructure

newHLAobjectRoot

public HLAobjectRootProxy newHLAobjectRoot()
                                    throws ObjectClassNotDefined,
                                           ObjectClassNotPublished,
                                           FederateNotExecutionMember,
                                           SaveInProgress,
                                           RestoreInProgress,
                                           RTIinternalError

Registers a new HLAobjectRoot and returns a proxy object that may be used to examine and control its state.

Returns:

the newly created proxy object

Throws:

ObjectClassNotDefined - if the specified object class is not defined

ObjectClassNotPublished - if the specified object class is not published

FederateNotExecutionMember - if the federate is not a member of an execution

SaveInProgress - if a save operation is in progress

RestoreInProgress - if a restore operation is in progress

RTIinternalError - if an internal error occurred in the run-time infrastructure

newHLAobjectRoot

public HLAobjectRootProxy newHLAobjectRoot(java.lang.String name)
                                    throws ObjectClassNotDefined,
                                           ObjectClassNotPublished,
                                           IllegalName,
                                           ObjectInstanceNameInUse,
                                           FederateNotExecutionMember,
                                           SaveInProgress,
                                           RestoreInProgress,
                                           RTIinternalError

Registers a new HLAobjectRoot with the specified name and returns a proxy object that may be used to examine and control its state.

Parameters:

name - the name of the new object

Returns:

the newly created proxy object

Throws:

ObjectClassNotDefined - if the specified object class is not defined

ObjectClassNotPublished - if the specified object class is not published

IllegalName - if the instance name has is illegal

ObjectInstanceNameInUse - if the instance name is already in use

FederateNotExecutionMember - if the federate is not a member of an execution

SaveInProgress - if a save operation is in progress

RestoreInProgress - if a restore operation is in progress

RTIinternalError - if an internal error occurred in the run-time infrastructure

newCountry

public CountryProxy newCountry()
                        throws ObjectClassNotDefined,
                               ObjectClassNotPublished,
                               FederateNotExecutionMember,
                               SaveInProgress,
                               RestoreInProgress,
                               RTIinternalError

Registers a new Country and returns a proxy object that may be used to examine and control its state.

Returns:

the newly created proxy object

Throws:

ObjectClassNotDefined - if the specified object class is not defined

ObjectClassNotPublished - if the specified object class is not published

FederateNotExecutionMember - if the federate is not a member of an execution

SaveInProgress - if a save operation is in progress

RestoreInProgress - if a restore operation is in progress

RTIinternalError - if an internal error occurred in the run-time infrastructure

newCountry

public CountryProxy newCountry(java.lang.String name)
                        throws ObjectClassNotDefined,
                               ObjectClassNotPublished,
                               IllegalName,
                               ObjectInstanceNameInUse,
                               FederateNotExecutionMember,
                               SaveInProgress,
                               RestoreInProgress,
                               RTIinternalError

Registers a new Country with the specified name and returns a proxy object that may be used to examine and control its state.

Parameters:

name - the name of the new object

Returns:

the newly created proxy object

Throws:

ObjectClassNotDefined - if the specified object class is not defined

ObjectClassNotPublished - if the specified object class is not published

IllegalName - if the instance name has is illegal

ObjectInstanceNameInUse - if the instance name is already in use

FederateNotExecutionMember - if the federate is not a member of an execution

SaveInProgress - if a save operation is in progress

RestoreInProgress - if a restore operation is in progress

RTIinternalError - if an internal error occurred in the run-time infrastructure

addInteractionListener

public void addInteractionListener(HelloWorldInteractionListener il)

Adds a listener for the interactions processed by this ambassador.

Parameters:

il - the listener object to add

removeInteractionListener

public void removeInteractionListener(HelloWorldInteractionListener il)

Removes a listener for the interactions processed by this ambassador.

Parameters:

il - the listener object to remove

receiveInteraction

public void receiveInteraction(InteractionClassHandle interactionClass,
                               ParameterHandleValueMap theParameters,
                               byte[] userSuppliedTag,
                               OrderType sentOrdering,
                               TransportationType theTransport)
                        throws InteractionClassNotRecognized,
                               InteractionParameterNotRecognized,
                               InteractionClassNotSubscribed,
                               FederateInternalError

Notifies the federate of a received interaction.

Specified by:

receiveInteraction in interface FederateAmbassador

Overrides:

receiveInteraction in class ProxyAmbassador

Parameters:

interactionClass - the class of the received interaction

theParameters - the map between parameter handles and the values of the identified parameters

userSuppliedTag - a user-supplied tag associated with the interaction

sentOrdering - the type of ordering with which the interaction was sent

theTransport - the type of transport associated with the interaction

Throws:

InteractionClassNotRecognized - if the interaction class was not recognized

InteractionParameterNotRecognized - if a parameter of the interaction was not recognized

InteractionClassNotSubscribed - if the federate had not subscribed to the interaction class

FederateInternalError - if an error occurs in the federate

discoverObjectInstance

public void discoverObjectInstance(ObjectInstanceHandle theObject,
                                   ObjectClassHandle theObjectClass,
                                   java.lang.String objectName)
                            throws CouldNotDiscover,
                                   ObjectClassNotRecognized,
                                   FederateInternalError

Notifies the federate of the presence of an object instance.

Specified by:

discoverObjectInstance in interface FederateAmbassador

Overrides:

discoverObjectInstance in class ProxyAmbassador

Parameters:

theObject - the instance handle of the newly discovered object

theObjectClass - the class handle of the newly discovered object

objectName - the name of the newly discovered object

Throws:

CouldNotDiscover - if the object could not be discovered

ObjectClassNotRecognized - if the object class was not recognized

FederateInternalError - if an error occurs in the federate

sendCommunication

public void sendCommunication(java.lang.String message,
                              byte[] userSuppliedTag)
                       throws InteractionClassNotPublished,
                              InteractionClassNotDefined,
                              InteractionParameterNotDefined,
                              FederateNotExecutionMember,
                              SaveInProgress,
                              RestoreInProgress,
                              RTIinternalError

A generic message.

Parameters:

message - The contents of the message.

userSuppliedTag - a user-supplied tag to accompany the interaction

Throws:

InteractionClassNotPublished - if the interaction class is not published

InteractionClassNotDefined - if the interaction class is not defined

InteractionParameterNotDefined - if one of the parameters is not defined

FederateNotExecutionMember - if the federate is not a member of an execution

SaveInProgress - if a save operation is in progress

RestoreInProgress - if a restore operation is in progress

RTIinternalError - if an internal error occurs in the run-time infrastructure