MIDlet suite library

Identifier:

org.eclipse.mtj.core.library.MIDletLibrary

Since:

0.9.1

Description:

Define the concept of MIDlet suite library. A MIDlet suite project will be able to select the different libraries that it wants to use and those libraries will be automatically added to the final MIDlet suite.

Configuration Markup:

<!ELEMENT extension (library+)+>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

<!ELEMENT library (ClasspathEntry+ , License , Security?)>

<!ATTLIST library

name CDATA #REQUIRED

version CDATA #REQUIRED

description CDATA #IMPLIED

visibility (PUBLIC|INTERNAL) >

name - The library name
version - Version identifier for the library.
Version identifiers have four components.
1. Major version. A non-negative integer.
2. Minor version. A non-negative integer.
3. Micro version. A non-negative integer.
4. Qualifier.
Here is the grammar for version strings.
```
  version ::= major('.'minor('.'micro('.'qualifier)?)?)?
   major ::= digit+
   minor ::= digit+
   micro ::= digit+
   qualifier ::= (alpha|digit|'_'|'-')+
   digit ::= [0..9]
   alpha ::= [a..zA..Z]
```
There must be no whitespace in version.

For more information see org.osgi.framework.Version
description - The description for the library.
visibility -

<!ELEMENT ClasspathEntry (AccessRule)*>

<!ATTLIST ClasspathEntry

jarFile CDATA #REQUIRED

javadocPath CDATA #IMPLIED

srcPath CDATA #IMPLIED>

jarFile - The absolute path of the binary archive.
javadocPath - The javadoc location.
srcPath - Path to the source archive or folder associated with this classpath entry

<!ELEMENT AccessRule EMPTY>

<!ATTLIST AccessRule

kind (ACCESSIBLE|NON_ACCESSIBLE|DISCOURAGED)

pattern CDATA #REQUIRED>

Describes an access rule to source and class files on a classpath entry. An access rule is composed of a file pattern and a kind (accessible, non accessible, or discouraged).

See org.eclipse.jdt.core.IAccessRule for more information about access rules.

kind - An access rule kind (accessible, non accessible, or discouraged).
ACCESSIBLE: indicates that files matching the rule's pattern are accessible.
NON_ACCESSIBLE: indicates that files matching the rule's pattern are non accessible.
DISCOURAGED: indicates that access to the files matching the rule's pattern is discouraged.
pattern - An access rule file pattern.
Files patterns look like relative file paths with wildcards and are interpreted relative to each entry's path. File patterns are case-sensitive and they can contain '**', '*' or '?' wildcards (see org.eclipse.jdt.core.IClasspathEntry#getExclusionPatterns() for the full description of their syntax and semantics). Note that file patterns must not include the file extension. com/xyz/tests/MyClass is a valid file pattern, whereas com/xyz/tests/MyClass.class is not valid.

For example, if one of the entry path is /Project/someLib.jar, there are no accessible rules, and there is one non accessible rule whith pattern com/xyz/tests/**, then class files like /Project/someLib.jar/com/xyz/Foo.class and /Project/someLib.jar/com/xyz/utils/Bar.class would be accessible, whereas /Project/someLib.jar/com/xyz/tests/T1.class and /Project/someLib.jar/com/xyz/tests/quick/T2.class would not be accessible.

<!ELEMENT License EMPTY>

<!ATTLIST License

name CDATA #REQUIRED

url CDATA #REQUIRED>

Licensing information

name - The license name
url - An valid URL to the license especification.

<!ELEMENT Security EMPTY>

<!ATTLIST Security

ProtectionDomain (MANUFACTURER|OPERATOR|THIRD_PARTY|UNTRUSTED)

Premissions CDATA #IMPLIED>

ProtectionDomain - A protection domain is a way to differentiate between downloaded MIDlet suites based on the entity that signed the MIDlet suite, and to grant or make available to a MIDlet suite a set of permissions. A domain binds a Protection Domain Root Certificate to a set of permissions.
- MANUFACTURER: The trusted manufacturer Protection Domain Root Certificate is used to verify manufacturer MIDlet suites.
- OPERATOR: A trusted operator Protection Domain Root Certificate is used to verify operator MIDlet suites.
- THIRD_PARTY:A trusted third party Protection Domain Root Certificate is used to verify third party MIDlet suites.
- UNTRUSTED: MIDlets suites that are unsigned will belong to the Untrusted domain.
Premissions - A comma separated list with named permissions defined by an API or function to prevent it from being used without authorization
permission1,permission2,...,permissionN

Copyright (c) 2008 Motorola. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html