com.signalsoftcorp.lst.client
Class MLP300LocationResponse

java.lang.Object
  |
  +--com.signalsoftcorp.lst.client.MLP300LocationResponse

public class MLP300LocationResponse
extends java.lang.Object

MLP300LocationResponse is the response object returned by a call to WLILocation.getLocation.

The MLP300 classes are an attempt to give an object oriented view of the XML dtd that defines the MLP3.0.0 protocol.

If a overall failure is recieved this could be found in the methods getResult getResId and getAddInfo. If no failure was recieved these will return null.

If no overall failure was recieved there will MLP300Positions in the Response If a failure was recieved for a specific MLP300Position. The specific failure can be found in the MLP300Position.getResult. MLP300Position.getResId. MLP300Position.getAddInfo. If a correct position is returned the above methods will return null and the correct Position will be returned in MLP300Position. An example how you could get positions is

    if(response.getResult()!=null)
    {
        System.out.println("Overall failure when getting a response, Result: "+response.getResult());
        System.out.println("ResId: "+response.getResId());
        //AddInfo not always returned
        if(response.getAddInfo()!=null)
        {
            System.out.println("AddInfo: "+response.getAddInfo());
        }
    }
    MLP300Position[] mLP300Positions=response.getMLP300Positions();
    for(int i=0;i<mLP300Positions.length;i++)
    {
        MLP300Msid mLP300Msid=mLP300Positions[i].getMLP300Msid();
        System.out.println("MSID: "+mLP300Msid.getMsid());
        if(mLP300Positions[i].getResult()!=null)
        {
            System.out.println("Failure, Result: "+mLP300Positions[i].getResult());
            System.out.println("ResId: "+mLP300Positions[i].getResId());
            //AddInfo not always returned
            if(mLP300Positions[i].getAddInfo()!=null)
            {
                System.out.println("AddInfo: "+mLP300Positions[i].getAddInfo());
            }
        }
        else
        {
            System.out.println("A correct position is recived,X: "+mLP300Positions[i].getX());
            System.out.println("Y: "+mLP300Positions[i].getY());
        }
    }
 
Error codes that can be specified.

See Also:
MLP300Error.OK, MLP300Error.SYSTEM_FAILURE, MLP300Error.UNSPECIFIED_ERROR, MLP300Error.UNAUTHORIZED_APPLICATION, MLP300Error.UNKNOWN_SUBSCRIBER, MLP300Error.ABSENT_SUBSCRIBER, MLP300Error.POSITION_METHOD_FAILURE, MLP300Error.CONGESTION_IN_LOCATION_SERVER, MLP300Error.CONGESTION_IN_MOBILE_NETWORK, MLP300Error.UNSUPPORTED_VERSION, MLP300Error.TOO_MANY_POSITION_ITEMS, MLP300Error.FORMAT_ERROR, MLP300Error.SYNTAX_ERROR, MLP300Error.PROTOCOL_ELEMENT_NOT_SUPPORTED, MLP300Error.SERVICE_NOT_SUPPORTED, MLP300Error.PROTOCOL_ELEMENT_ATTRIBUTE_NOT_SUPPORTED, MLP300Error.INVALID_PROTOCOL_ELEMENT_VALUE, MLP300Error.INVALID_PROTOCOL_ELEMENT_ATTRIBUTE, MLP300Error.PROTOCOL_ELEMENT_VALUE_NOT_SUPPORTED, MLP300Error.PROTOCOL_ELEMENT_ATTRIBUTE_VALUE_NOT_SUPPORTED, MLP300Error.QOP_NOT_ATTAINABLE, MLP300Error.POSITIONING_NOT_ALLOWED, MLP300Error.DISALLOWED_BY_LOCAL_REGULATIONS, MLP300Error.MISCONFIGURATION_OF_LOCATION_SERVER

Constructor Summary
MLP300LocationResponse()
           
 
Method Summary
 java.lang.String getAddInfo()
          A text string containing additional information about a certain result.
 MLP300Position[] getMLP300Positions()
          The actual position of mobile stations.
 int getResId()
          The field represents a numeric representation of a result message.
 java.lang.String getResult()
          The result of the request.
 void setAddInfo(java.lang.String addInfo)
          A text string containing additional information about a certain result.
 void setMLP300Position(MLP300Position[] mLP300Positions)
          The actual position of mobile stations.
 void setResId(int resId)
          The field represents a numeric representation of a result message.
 void setResult(java.lang.String result)
          The result of the request.
 java.lang.String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

MLP300LocationResponse

public MLP300LocationResponse()
Method Detail

getResult

public java.lang.String getResult()
The result of the request. This corresponds to the integer that is returned by the method getResId()
Returns:
result The result of the request.

setResult

public void setResult(java.lang.String result)
The result of the request. This corresponds to the integer that is returned by the method getResId()
Parameters:
result - The result of the request.

getResId

public int getResId()
The field represents a numeric representation of a result message.
Returns:
resId The field represents a numeric representation of a result message.

setResId

public void setResId(int resId)
The field represents a numeric representation of a result message.
Parameters:
resId - The field represents a numeric representation of a result message.

getAddInfo

public java.lang.String getAddInfo()
A text string containing additional information about a certain result.
Returns:
addInfo A text string containing additional information about a certain result.

setAddInfo

public void setAddInfo(java.lang.String addInfo)
A text string containing additional information about a certain result.
Parameters:
addInfo - A text string containing additional information about a certain result.

getMLP300Positions

public MLP300Position[] getMLP300Positions()
The actual position of mobile stations. See MLP300Position.
Returns:
MLP300Position[] MLP300Position[] contains the actual position of mobile stations.

setMLP300Position

public void setMLP300Position(MLP300Position[] mLP300Positions)
The actual position of mobile stations. See MLP300Position.
Parameters:
MLP300Position[] - MLP300Position[] contains the actual position of mobile stations.

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object


Copyright © SignalSoft Corp. All Rights Reserved.