Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 6 Metadata : AE Schema Types and SDK Classes

AE Schema Types and SDK Classes
This section discusses SDK date and time classes, then lists the mapping of type names to SDK classes for both C++ and Java.
SDK Date and Time Classes
TIBCO Adapter SDK contains a number of classes that can be used to specify date and time information.
By default, MDateTime uses the local time.
When data of type MDateTime are sent, they are converted from the time zone used by the sender to GMT/UTC. When data of type MDateTime are received, they are converted from GMT/UTC to the local time zone at the location of the recipient. This may lead to confusing results, especially if the message crosses the international date line.
Sent using TIBCO Rendezvous as a TIBRVMSG_DATETIME type for aeRvMsg format.
MDateTime should be used when sender and receiver of a time value need a common reference timezone. Since the timezone is fixed at GMT/UTC, additional computation can be made on receiver side without ambiguity.
Time should be used when the time value is to be kept without conversion to/from GMT/UTC.
Date should be used when the date is to be kept without conversion to/from GMT/UTC.
Mapping AESchema Types to C++ MData Subclasses
This section describes the mapping between class names and MData subclasses for the C++ SDK.
Table 27 lists the type (class) defined in the repository, the corresponding MData class, and whether a default value is supported.
Yes, treated as MStringData
p is the total number of digits; by default unlimited
s is the number of digits after the decimal point; by default unlimited
For example, the number 123.45 would be represented by 5.2, not by 3.2.
 
Prespecifying Data Length
For some types, such as char or binary, you can pre specify the length of the data in the repository, then refer to that prespecified bounded data type. For example, binary.10 refers to binary data containing at most 10 bytes.
Mapping AESchema Types to Java Classes
Table 28 lists how the types you specify as an attribute’s class in the repository map to classes in an SDK application. Most of the types map directly to a corresponding Java class. A few others map to a class defined by the SDK.
p is the total number of digits; by default unlimited
s is the number of digits after the decimal point; by default unlimited
Table 29 provides more detail on the types that are currently supported for attributes.
 
Fixed number. Precision (p) is the total number of digits. Scale (s) is the number of digits to the right of the decimal point and must be less than or equal to the precision.
A time in a subset ISO 8601 format, with no date and no time zone. Fractional seconds may be as precise as nanoseconds.
Binary. length (n) may be specified. Default is unlimited.
Character string, n characters long. Length may be specified. Default is 1.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved