CADI.Common.Network.JPIP
Class TargetField

java.lang.Object
  CADI.Common.Network.JPIP.TargetField

public class TargetField
extends java.lang.Object

This class is used to store the target fields.

Further information, see ISO/IEC 15444-9 section C.2

Version:

1.0 2007/10/26

Author:

Group on Interactive Coding of Images (GICI)

Field Summary

int[]	subtarget subtarget = "subtarget" "=" byte-range byte-range = UINT_RANGE May be used to qualify the original named resource through the specification of a byte range.
java.lang.String	target target = "target" "=" PATH Specifies the original named resource (often the name of a file on the server).
java.lang.String	tid tid = "tid" "=" target-id target-id = TOKEN This field may be used to supply a target-id string, which was previously generated by the server to absolutely identify the logical target that is being accessed, including any discretionary transcoding performed by the server.

Constructor Summary

TargetField()
Constructor.

Method Summary

void	list(java.io.PrintStream out) Prints this Target fields out to the specified output stream.
void	reset() Sets the attributes to its initial values.
java.lang.String	toString() For debugging purposes.

Methods inherited from class java.lang.Object

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

Field Detail

target

public java.lang.String target

target = "target" "=" PATH Specifies the original named resource (often the name of a file on the server).

If the Target request field is missing then the original named resource is determined by other means.

subtarget

public int[] subtarget

subtarget = "subtarget" "=" byte-range
byte-range = UINT_RANGE

May be used to qualify the original named resource through the specification of a byte range. The logical target is to be interpreted as the indicated byte range of the original named resource.

The lower and upper bounds of the supplied byte-range are inclusive, an 0 refers to the first byte of the target file.

tid

public java.lang.String tid

tid = "tid" "=" target-id
target-id = TOKEN

This field may be used to supply a target-id string, which was previously generated by the server to absolutely identify the logical target that is being accessed, including any discretionary transcoding performed by the server. The logical target name is not necessarily unique and does not necessarily correspond to a single encoding of its contents, whereas the target-id string, together with the original resource name and byte range, should absolutely identify both the imagery and its encoding.

If target-id is "0", the logical target is specified through the use of the Target, Sub-target and JPIP URL path component, and the client is explicitly requesting that the server inform it of the assigned target-id, if there is one. The server shall include a Target ID header in its response to all client requests with a target-id of "0".

target-id shall not exceed 255 characters in length.

Constructor Detail

TargetField

public TargetField()

Constructor.

Method Detail

reset

public void reset()

Sets the attributes to its initial values.

toString

public java.lang.String toString()

For debugging purposes.

Overrides:

toString in class java.lang.Object

list

public void list(java.io.PrintStream out)

Prints this Target fields out to the specified output stream. This method is useful for debugging.

Parameters:

out - an output stream.