Runtime environment notes

System properties

Key

Description

microedition.m2g.version

The String returned designates the version of the Mobile Scalable 2D Vector Graphics API specification that is implemented. It is "1.1" for this version of the specification.

microedition.m2g.svg.baseProfile

The String returned indicates the base Profile of SVG that is supported by the underlying implementation. It is "tiny" for this version of the specification.

microedition.m2g.svg.version

The String returned indicates the version of SVG that is supported by the underlying implementation. It is "1.1" for this version of the specification.

Security settings

JSR226 does not define any security mechanism. Rather, implementations of JSR226 API is subject to the security mechanisms provided by the underlying profile and configuration, for example OMA DRM.

The Scalable 2D Vector Graphics API can be used to access OMA DRM protected files, for example, SVG files, SVG or raster image resources. The table below defines the access modes available in certain security domains.

Table: DRM modes accessible in domains

DRM mode

Trusted third-party

Untrusted

Decrypted

No

No

Encrypted mode

No

No

Default mode

Yes

Yes

The DRM encrypted mode is not supported and java.lang.IllegalArgumentException is thrown.

When a MIDlet uses a default mode URL in the Scalable 2D Graphics API, access to SVG document via DOM API is not allowed, and java.lang.SecurityException is thrown. Only rendering of the content is allowed in the default DRM mode.

DRM preview mechanism is not available to MIDlets that do not belong to the manufacturer security domain; java.lang.SecurityException is thrown.

The exception java.lang.SecurityException is thrown when a MIDlet tries to open a file but it does not have access rights for it.

SVG file’s DRM purpose is “display” and MIME (Multipurpose Internet Mail Extensions) is “image/svg+xml”.

Security exceptions

The Scalable 2D Vector Graphics API throws a security exception if the API is called without the appropriate security permissions. For example, if the application does not have the necessary privilege rights to access SVG content, the API returns java.lang.SecurityException.