This specification defines the following property values (in addition to
those defined in the underlying configuration that MUST be made available
to the application using java.lang.System.getProperty
. Other
properties may be available from other configurations, profiles, or from the
implementation.
System Properties |
|
---|---|
System Property |
Description |
|
A unique hardware device identifier that MAY correspond to a value of one of the microedition.deviceid.* values. |
|
A unique hardware device identifier corresponding to a UUID |
|
A unique hardware device identifier corresponding to the device's IMEI |
|
A unique hardware device identifier corresponding to the device's ESN |
|
A unique hardware device identifier corresponding to the device's MEID |
|
A unique hardware device identifier corresponding to the device's pESN |
|
A property indicating whether the device with this MEEP 8 implementation has or has not a unique device id. |
|
An identifier for the vendor of the device with this MEEP 8 implementation. |
|
A property indicating whether the device with this MEEP 8 implementation has or has not a unique vendor. |
|
The current locale of the device, MUST NOT be |
|
A blank (Unicode U+0020) separated list of the Java ME profiles that this device supports. For a device implementing a certain ME profile version, this property MUST contain at least a string identifying the recent profile version. |
|
Name of the host platform or device |
|
A string representing the active Authentication Provider. |
|
A string representing the active Security Policy Provider. |
|
A comma separated list of available logical serial ports |
|
The local hostname (if available) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The microedition.deviceid
property MUST always
provide a value. Since there is no standard for device IDs
in the embedded world, this value MAY correspond to one of
the microedition.deviceid.*
values if present,
or it MAY contain another value. If the value presents a
device ID being guaranteed unique, the
microedition.deviceid.isunique
property MUST
contain the value true
.
As in the embedded world a unique device ID is not mandatory,
the value of microedition.deviceid
MAY also be
microedition.deviceid.UNKNOWN
. In this case
or if it contains the value of a device ID, but this device
ID cannot be guaranteed to be unique, the value of the
microedition.deviceid.isunique
property MUST be
false
.
The microedition.deviceid.uuid
property MAY
contain a UUID string value that can be used to uniquely
identify the device.
The format of the value of this property, if present, MUST
correspond to a Universally Unique Identifier (UUID) as
defined in [RFC4122].
This value MUST consist of 32 hexadecimal digits.
Implementations SHOULD use UUID version 1 if a 48 bit IEEE
address is available; otherwise, implementations SHOULD use
version 4 UUID using a randomly or pseudo-randomly generated
48 bit value. The value of this property, if present, MUST
be identical for all concurrently executing or consecutively
invoked applications on a device.
The microedition.deviceid.imei
property MAY
contain an IMEI string value that can be used to uniquely
identify the device.
The format of the value of this property, if present, MUST
correspond to an International Mobile Station Equipment
Identity (IMEI) as defined in
[3GPP-TS23.003].
The microedition.deviceid.esn
property MAY
contain an ESN string value that can be used to uniquely
identify the device.
The format of the value of this property, if present, MUST
correspond to an Electronic Serial Number (ESN) as defined
in [TIA-ESN] and MUST
consist of 8 hexadecimal digits.
The microedition.deviceid.meid
property MAY
contain an MEID string value that can be used to uniquely
identify the device. The format of the value of this property,
if present, MUST correspond to a Mobile Equipment Identifier
(MEID) as defined in
[3GPP2 S.R0048-A]
and MUST consist of 14 hexadecimal digits.
The microedition.deviceid.pesn
property MAY
contain a pESN string value that can be used to uniquely
identify the device.
The format of the value of this property, if present, MUST
correspond to a Pseudo Electronic Serial Number (pESN) as
defined in
[3GPP2 X.S0008-0]
and MUST consist of 8 hexadecimal digits.
The microedition.deviceid.isunique
property MUST
contain a value true
or false
.
If the value of the corresponding system property
microedition.deviceid
is guaranteed to be a deviceid
being unique, the value MUST be true
. If the value
of the corresponding system property
microedition.deviceid
is
microedition.deviceid.UNKNOWN
or represents a
device ID not being guaranteed to be unique, the value MUST
be false
.
The microedition.devicevendor
property MUST always
provide a value. Since there is no standard for unique device
vendors in the embedded world, the value MAY be
microedition.devicevendor.UNKNOWN
. In this case
or if it contains a name of a vendor that cannot be guaranteed
to be unique, the value of the
microedition.deviceid.isunique
property MUST be
false
, otherwise it MUST be true
.
The microedition.devicevendor.isunique
property MUST
contain a value true
or false
.
If the value of the corresponding system property
microedition.devicevendor
is guaranteed to be unique,
the value MUST be true
. If the value
of the corresponding system property
microedition.devicevendor
is
microedition.devicevendor.UNKNOWN
or represents a
vendor name not being guaranteed to be unique, the value MUST
be false
.
The microedition.locale
property MUST
include at least the language code, and SHOULD also
include the country code, followed by an OPTIONAL
variant, separated by "-" (Unicode U+002D). For example,
fr-FR
or en-US
or zh-CN-Hans
.
The language codes MUST be the lower-case, two-letter codes as defined by ISO 639-1:2002.
The country codes MUST be the upper-case, two-letter codes as defined by ISO 3166-1:1997.
(Note: Former versions of ME profiles used the HTTP
formatting of language tags as defined in
[RFC3066], Tags for
the Identification of Languages. This is
different from the Java SE definition for java.util.Locale
printed strings where fields are separated by "_" (Unicode U+005F).)
The microedition.profiles
system property MUST NOT contain
different versions of the same profile.
In particular, previous profile versions MUST NOT be listed, only the recent one.
The value of the microedition.platform
system property MUST
conform to the following syntax (BNF):
<property value> | ::= <Manufacturer Name>"/" <Device Model Identifier> ["/"<Version Identifier> ["/"<Additional Comment>]] |
<Manufacturer Name> | ::= Manufacturer Name |
<Device Model Identifier> | ::= Device Model Identifier |
<Version Identifier> | ::= Version Identifier |
<Additional Comment> | ::= Additional Comment |
Manufacturer name and device model number are mandatory and MUST be separated with a forward slash (/). Optional version identifier MAY be present. In case there is a version identifier, additional comments MAY be present as well. The version identifier and optional additional comments MUST be separated from the rest of the string with a forward slash (/) each. The value of the property MUST NOT contain any forward slash (/) characters other than those that are used as delimiters. For the sake of readability, it is recommended that the property string does not contain white spaces.
Examples for recommended values of microedition.platform
system property are:
CompanyA/ABC123
CompanyB/Z456/23E-4.1Advanced
CompanyB/Z456/23E-4.1Advanced/EuropaVersion
The value of the microedition.commports
system property
MUST contain a comma separated list of available logical port names, any of
which can be combined with a comm:
prefix as the URL
string to be used to open a serial port connection. See
javax.microedition.io.CommConnection
for more information.
The value of the microedition.hostname
system property
MUST contain the host name of the local device, if it is available.
Remark : System properties describing subscriber IDs that used to be available in former profile versions have been replaced by properties in the newly introduced Cellular API and can be retrieved via Subscriber#getProperties() method.
For every optional package in MEEP 8 and every component
being optional in the underlying CLDC 8 configuration (such as
GCF), there exists a system property with
the boolean value true
if the respective optional
package / component is implemented in the recent CLDC 8 plus
MEEP 8 software stack, otherwise the respective system property
is not available so that a call to System.getProperty
would return null
.
Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.