- COMPOSED OF
XML::SRS::Result - Represents the result of an individual SRS query or action
my $response = XML::SRS->parse($xml); my $results = $response->results; # If the response was for a transaction involving domains, get the # list of domain records returned in the response (as an array ref) my $domains = $results->responses;
This class represents the response to an individual transaction in an SRS request. Each response may have its own list of 'responses'. For example, a DomainDetailsQry might return multiple domains. These domains can be obtained via the 'responses' attribute of this class (see below).
The root XML element of this class is 'Response' XML element. However, as this clashes with the top level 'Response' (i.e. 'NZSRSResponse' XML element), it has been renamed 'Result'.
Each attribute of this class has an accessor/mutator of the same name as the attribute. Additionally, they can be passed as parameters to the constructor.
An array ref of objects that compose the XML::SRS::ActionResponse role. This corresponds to the responses to the indvidual transactions of a request. The objects returned here will be in a class dependent on the response type, for example, a DomainDetailsQry will return 0 or more XML::SRS::Domain objects, while a HandleDetailsQry will return 0 or more XML::SRS::Handle objects. See the POD for each individual transaction for details on what type of response to expect.
Returns the first response in the list, or undef if there are none. It's a fairly common case to only expect one response, so this attribute is often useful.
The GetMessages transaction is somewhat different, in that it returns a list of results (i.e. XML::SRS::Result objects), rather than responses. This attribute contains those result objects.
The name of the 'action' this result relates to. For example 'Whois' if this is the result of a 'Whois' request. Maps to the 'Action' XML attribute.
The front end service id of the request. Maps to the 'FeId' XML attribute.
The front end sequence number of the request. Maps to the 'FeSeq' XML attribute.
Maps to the 'OrigRegistrarId' XML attribute
Maps to the 'RecipientRegistrarId' XML attribute
Maps to the 'TransId' XML attribute
Maps to the 'Rows' XML attribute
Maps to the 'MoreRowsAvailable' XML attribute
Maps to the 'Count' XML attribute
Construct a new XML::SRS::Request object. %params specifies the initial values of the attributes.