CORBA Programming Reference

PortableServer::IdAssignmentPolicy

Synopsis

Specifies whether ObjectIds in the created POA are generated by the application or by the ORB.

Description

Objects with the IdAssignmentPolicy interface are obtained using the POA::create_id_assignment_policy operation and are passed to the POA::create_POA operation to specify whether ObjectIds in the created POA are generated by the application or by the ORB. The following values can be supplied:

USER_ID—objects created with that POA are assigned ObjectIds only by the application.
SYSTEM_ID—objects created with that POA are assigned ObjectIds only by the POA. If the POA also has the PERSISTENT policy, assigned ObjectIds must be unique across all instantiations of the same POA.

If no IdAssignmentPolicy is specified at POA creation, the default is SYSTEM_ID.

Note: This function is supported only for a joint client/server.

Request Member Functions

The mapping of these member functions to C++ is as follows:

// C++
class Request
{
  public:
    Object_ptr target() const;
    const char *operation() const;
    NamedValue_ptr result();
    NVList_ptr arguments();
    Environment_ptr env();
    ExceptionList_ptr exceptions();
    ContextList_ptr contexts();
    void ctx(Context_ptr);
    Context_ptr ctx() const

    // argument manipulation helper functions
    Any &add_in_arg();
    Any &add_in_arg(const char* name);
    Any &add_inout_arg():
    Any &add_inout_arg(const char* name);
    Any &add_out_arg():
    Any &add_out_arg(const char* name);
    void set_return_type(TypeCode_ptr tc);
    Any &return_value();

    void invoke();
    void send_oneway();
    void send_deferred();
    void get_response();
    Boolean poll_response();
};

Note: The add_*_arg, set_return_type, and return_value member functions are added as shortcuts for using the attribute-based accessors.

The following sections describe these member functions.