|
Samchon Framework for CPP
1.0.0
|
|
Samchon Framework for CPP
1.0.0
|
An array of DistributedClient(s). More...
#include <DistributedClientArray.hpp>
Public Member Functions | |
| DistributedClientArray () | |
| Default Constructor. More... | |
| virtual void | construct (std::shared_ptr< library::XML >) override |
| Construct data of the Entity from an XML object. More... | |
| virtual void | start () override |
| Start interaction. More... | |
| virtual auto | toXML () const -> std::shared_ptr< library::XML > override |
| Get an XML object represents the EntityGroup. More... | |
 Public Member Functions inherited from samchon::protocol::master::DistributedSystemArray | |
| DistributedSystemArray () | |
| Default Constructor. More... | |
| virtual void | allocateRoles () |
| Allocate roles to each distributed processing system. More... | |
| auto | hasRole (const std::string &) const -> bool |
| Test whether has a role. More... | |
| auto | getRole (const std::string &) const -> std::shared_ptr< DistributedSystemRole > |
| Get a role. More... | |
| Public Member Functions inherited from samchon::protocol::ExternalSystemArray | |
| ExternalSystemArray () | |
| Default Constructor. More... | |
| auto | hasRole (const std::string &) const -> bool |
| Test whether has a role. More... | |
| auto | getRole (const std::string &) const -> std::shared_ptr< ExternalSystemRole > |
| Get a role. More... | |
| virtual void | sendData (std::shared_ptr< Invoke >) override |
| Sends an Invoke message to related ExternalSystem(s). More... | |
| virtual void | replyData (std::shared_ptr< Invoke >) override |
| Handle replied Invoke message. More... | |
| virtual auto | TAG () const -> std::string override |
| A tag name when represented by XML. More... | |
| virtual auto | CHILD_TAG () const -> std::string override |
| A tag name of children. More... | |
| Public Member Functions inherited from samchon::protocol::EntityGroup< _Container, _ETy, T > | |
| EntityGroup () | |
| Default Constructor. More... | |
| auto | has (const std::string &key) const -> bool |
| Indicates whether a container has an object having the specified identifier. More... | |
| auto | get (const std::string &key) -> value_type & |
| Access the element by specified identifier(key). More... | |
| auto | get (const std::string &key) const -> const value_type & |
| Access the const element by specified identifier(key). More... | |
| Public Member Functions inherited from samchon::protocol::Entity | |
| Entity () | |
| Default Constructor. More... | |
| virtual auto | key () const -> std::string |
| Get a key that can identify the Entity uniquely. More... | |
| Public Member Functions inherited from samchon::protocol::IEntityGroup | |
| IEntityGroup () | |
| Default Constructor. More... | |
| Public Member Functions inherited from samchon::protocol::IProtocol | |
| IProtocol () | |
| Default Constructor. More... | |
| Public Member Functions inherited from samchon::protocol::ExternalClientArray | |
| ExternalClientArray () | |
| Default Constructor. More... | |
Additional Inherited Members | |
| Protected Member Functions inherited from samchon::protocol::master::DistributedSystemArray | |
| virtual auto | createRole (std::shared_ptr< library::XML >) -> DistributedSystemRole *=0 |
| Factory method of a DistributedSystemRole. More... | |
| Protected Member Functions inherited from samchon::protocol::EntityGroup< _Container, _ETy, T > | |
| virtual auto | createChild (std::shared_ptr< library::XML >) -> entity_type *=0 |
| Factory method of a child Entity. More... | |
| Protected Member Functions inherited from samchon::protocol::ExternalClientArray | |
| virtual auto | PORT () const -> int |
| Port number of the server. More... | |
| virtual auto | MY_IP () const -> std::string |
| (optional) Server's IP More... | |
| virtual void | addClient (Socket *) override |
| Handling connection of a physical client. More... | |
| Protected Attributes inherited from samchon::protocol::master::DistributedSystemArray | |
| Dictionary< std::shared_ptr< DistributedSystemRole > > | roleDictionary |
| A dictionary of role objects. More... | |
| struct library::GAParameters | gaParameters |
| A structure of parameters for genetic algorithm. More... | |
| Protected Attributes inherited from samchon::protocol::ExternalClientArray | |
| std::string | myIP |
| A custom ip address of my system to bind. More... | |
| int | port |
| A port number for accepting external clients. More... | |
An array of DistributedClient(s).
DistributedClientArray is an DistributedSystemArray specialized in clients' driver.
DistributedSystemArray class is an ExternalSystemArray and an abstract class containing and managing distributed system drivers within framework of master. The DistributedSystemArray class allocates DistributedSystemRole objects to DistributedSystem objects for optimization.
Unlike the ExternalSystemRole class which is dependent on an ExternalSystem, DistributedSystemRole is not dependent on a DistributedSystem and even can be allocated to multiple DistributedSystem objects. Allocation of DistributedSystemRole(s) to DistributedSystem(s) is determined by estimation of performance index pursuing best distribution. If number of DistributedSystem and DistributedSystemRole objects is not a lot, optimize by combined permuation algorithm. Else the objects are a lot, the allocation will be optimized by genetic algorithm.
ExternalSystemArray is an abstract class containing and managing external system drivers.
Also, ExternalSystemArray can access to ExternalSystemRole(s) directly. With the method, you can use an ExternalSystemRole as "logical proxy" of an ExternalSystem. Of course, the ExternalSystemRole is belonged to an ExternalSystem. However, if you access an ExternalSystemRole from an ExternalSystemArray directly, not passing by a belonged ExternalSystem, and send an Invoke message even you're not knowing which ExternalSystem is related in, the ExternalSystemRole acted a role of proxy.
It's called as "Proxy pattern". With the pattern, you can only concentrate on ExternalSystemRole itself, what to do with Invoke message, irrespective of the ExternalSystemRole is belonged to which ExternalSystem.
Definition at line 22 of file DistributedClientArray.hpp.
| samchon::protocol::master::DistributedClientArray::DistributedClientArray | ( | ) |
Default Constructor.
|
overridevirtual |
Construct data of the Entity from an XML object.
Constructs the EntityGroup's own member variables only from the input XML object.
Do not consider about constructing children Entity objects' data in EntityGroup::construct(). Those children Entity objects' data will constructed by their own construct() method. Even insertion of XML objects representing children are done by abstract method of EntityGroup::toXML().
Constructs only data of EntityGroup's own.
Overrides the construct() method and fetch data of member variables from the XML.
By recommended guidance, data representing member variables are contained in properties of the put XML object.
| xml | An xml used to construct data of entity |
Reimplemented from samchon::protocol::ExternalClientArray.
Reimplemented in samchon::protocol::master::DistributedClientArrayMediator.
|
overridevirtual |
Start interaction.
An abstract method starting interaction with external systems.
If external systems are servers, starts connection to them, else clients, opens a server and accepts the external systems. You can addict your own procudures of starting drivers, but if you directly override method of abstract ExternalSystemArray, be careful about virtual inheritance.
Reimplemented from samchon::protocol::ExternalClientArray.
Reimplemented in samchon::protocol::master::DistributedClientArrayMediator.
|
overridevirtual |
Get an XML object represents the EntityGroup.
Archives the EntityGroup's own member variables only to the returned XML object.
Do not consider about archiving children Entity objects' data in EntityGroup::toXML(). Those children Entity objects will converted to XML object by their own toXML() method. The insertion of XML objects representing children are done by abstract method of EntityGroup::toXML().
Archives only data of EntityGroup's own.
Returns an XML object that can represents the Entity containing member variables into properties.
A member variable (not object, but atomic value like number, string or date) is categorized as a property within the framework of entity side. Thus, when overriding a toXML() method and archiving member variables to an XML object to return, puts each variable to be a property belongs to only an XML object.
Don't archive the member variable of atomic value to XML::value causing enormouse creation of XML objects to number of member variables. An Entity must be represented by only an XML instance (tag).
| Standard Usage | Non-standard usage abusing value |
|---|---|
| <memberList> <member id='jhnam88' name='Jeongho+Nam' birthdate='1988-03-11' /> <member id='master' name='Administartor' birthdate='2011-07-28' /> </memberList> | <member> <id>jhnam88</id> <name>Jeongho+Nam</name> <birthdate>1988-03-11</birthdate> </member> |
Reimplemented from samchon::protocol::ExternalClientArray.
Reimplemented in samchon::protocol::master::DistributedClientArrayMediator.
1.8.11 
