You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@avalon.apache.org by mc...@apache.org on 2004/02/23 15:36:38 UTC
cvs commit: avalon/merlin/platform/xdocs/meta/block/classloader/grant/permission action.xml index.xml navigation.xml
mcconnell 2004/02/23 06:36:38
Modified: merlin/platform/xdocs/meta/block/classloader/grant index.xml
navigation.xml
Added: merlin/platform/xdocs/meta/block/classloader/grant/certificates
index.xml navigation.xml pkcs7.xml x509.xml
merlin/platform/xdocs/meta/block/classloader/grant/permission
action.xml index.xml navigation.xml
Removed: merlin/platform/xdocs/meta/block/classloader/grant
certificates.xml permission.xml pkcs7.xml x509.xml
Log:
Upgrade classloader docs.
Revision Changes Path
1.4 +3 -10 avalon/merlin/platform/xdocs/meta/block/classloader/grant/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/avalon/merlin/platform/xdocs/meta/block/classloader/grant/index.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- index.xml 23 Feb 2004 13:00:31 -0000 1.3
+++ index.xml 23 Feb 2004 14:36:38 -0000 1.4
@@ -34,13 +34,13 @@
<table>
<tr><th>Element</th><th>Occurance</th><th>Description</th></tr>
<tr>
- <td><a href="permission.html">permission</a></td><td>0..n</td>
+ <td><a href="permission/index.html">permission</a></td><td>0..n</td>
<td>
The permission descriptor.
</td>
</tr>
<tr>
- <td><a href="certificates.html">certificates</a></td><td>0..1</td>
+ <td><a href="certificates/index.html">certificates</a></td><td>0..1</td>
<td>
The certificates descriptor. In this nested element, one can list
the certificates required for the code sources. Either X.509 or
@@ -62,23 +62,16 @@
<subsection name="Example XML">
<source><![CDATA[
-<classloader>
- <classpath>
- <repository>
- <resource id="tutorial:composition-api" version="1.0"/>
- </repository>
- </classpath>
<grant>
<permission class="java.lang.RuntimePermission" name="getClassLoader" />
<permission class="java.util.PropertyPermission" name="java.*" >
<action>read</action>
</permission>
- <permission class="java.util.PropertyPermission" name="com.mycompany.*" >
+ <permission class="java.util.FilePermission" name="com.mycompany.*" >
<action>read</action>
<action>write</action>
</permission>
</grant>
-</classloader>
]]></source>
</subsection>
1.3 +4 -1 avalon/merlin/platform/xdocs/meta/block/classloader/grant/navigation.xml
Index: navigation.xml
===================================================================
RCS file: /home/cvs/avalon/merlin/platform/xdocs/meta/block/classloader/grant/navigation.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- navigation.xml 25 Jan 2004 13:28:48 -0000 1.2
+++ navigation.xml 23 Feb 2004 14:36:38 -0000 1.3
@@ -42,7 +42,10 @@
<item name="classloader" href="/meta/block/classloader/index.html">
<item name="classpath" href="/meta/block/classloader/classpath/index.html"/>
<item name="library" href="/meta/block/classloader/extensions.html"/>
- <item name="grant" href="/meta/block/classloader/grant/index.html"/>
+ <item name="grant" href="/meta/block/classloader/grant/index.html">
+ <item name="permission" href="/meta/block/classloader/grant/permission/index.html"/>
+ <item name="certificates" href="/meta/block/classloader/grant/certificates/index.html"/>
+ </item>
</item>
<item name="component" href="/meta/block/components/index.html"/>
<item name="container" href="/meta/block/index.html"/>
1.1 avalon/merlin/platform/xdocs/meta/block/classloader/grant/certificates/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<header>
<title>Certificates Directive</title>
<authors>
<person name="Stephen McConnell" email="mcconnell@apache.org"/>
<person name="Niclas Hedhman" email="niclas@hedhman.org"/>
</authors>
</header>
<body>
<section name="Certificates Directive">
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Occurance</th><th>Description</th></tr>
<tr>
<td><a href="x509.html">x509</a></td><td>0..n</td>
<td>
The descriptor for X.509 certificate. One element is required
for each certificate.
</td>
</tr>
<tr>
<td><a href="pkcs7.html">pkcs7</a></td><td>0..n</td>
<td>
The action descriptor.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>
A set of digital certificate references.
</p>
</subsection>
<subsection name="Example XML">
<source><![CDATA[
<certificates>
<x509 href="http://niclas.hedhman.org/certs/signature.x509" />
<pkcs7 href="http://niclas.hedhman.org/certs/signature.cert" />
</certificates>
]]></source>
</subsection>
</section>
</body>
</document>
1.1 avalon/merlin/platform/xdocs/meta/block/classloader/grant/certificates/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<project>
<title>Merlin</title>
<body>
<links>
<item name="Apache" href="http://apache.org/"/>
<item name="Avalon" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/product/framework/"/>
<item name="Containers" href="http://avalon.apache.org/product/containers/"/>
<item name="Components" href="http://avalon.apache.org/product/components/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="block.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html">
<item name="classpath" href="/meta/block/classloader/classpath/index.html"/>
<item name="library" href="/meta/block/classloader/extensions.html"/>
<item name="grant" href="/meta/block/classloader/grant/index.html">
<item name="permission" href="/meta/block/classloader/grant/permission/index.html"/>
<item name="certificates" href="/meta/block/classloader/grant/certificates/index.html">
<item name="x509" href="/meta/block/classloader/grant/certificates/x509.html"/>
<item name="pkcs7" href="/meta/block/classloader/grant/certificates/pkcs7.html"/>
</item>
</item>
</item>
<item name="component" href="/meta/block/components/index.html"/>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
</menu>
<menu name="Resources">
<item name="Javadoc" href="/api/index.html"/>
<item name="Download" href="/resources/download.html"/>
<item name="Roadmap" href="/resources/roadmap/index.html"/>
<item name="DPML" href="/dpml/index.html"/>
</menu>
<menu name="Related Projects">
<item name="Meta" href="http://avalon.apache.org/meta"/>
<item name="Utilities" href="http://avalon.apache.org/util"/>
<item name="Repository" href="http://avalon.apache.org/repository"/>
</menu>
</body>
</project>
1.1 avalon/merlin/platform/xdocs/meta/block/classloader/grant/certificates/pkcs7.xml
Index: pkcs7.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<header>
<title>PKCS7 Directive</title>
<authors>
<person name="Stephen McConnell" email="mcconnell@apache.org"/>
<person name="Niclas Hedhman" email="niclas@hedhman.org"/>
</authors>
</header>
<body>
<section name="PKCS7 Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>href</td><td>yes</td>
<td>
The name of the file containing 0, one or many PKCS#7 encoded
certificates.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>
Each <pkcs7> element only points to a PKCS#7 encoded file.
The "href" attribute is any valid URL.
</p>
</subsection>
<subsection name="Example XML">
<p>
The following example block.xml demonstrates the inclusion of three blocks within another enclosing block. In this example, the common shared API (containing service interfaces classes is declared in the containing block classloader).
</p>
<source><![CDATA[
<certificates>
<pkcs7 href="http://niclas.hedhman.org/certs/signature.cert" />
</certificates>
]]></source>
</subsection>
</section>
</body>
</document>
1.1 avalon/merlin/platform/xdocs/meta/block/classloader/grant/certificates/x509.xml
Index: x509.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<header>
<title>X509 Directive</title>
<authors>
<person name="Stephen McConnell" email="mcconnell@apache.org"/>
<person name="Niclas Hedhman" email="niclas@hedhman.org"/>
</authors>
</header>
<body>
<section name="X509 Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>href</td><td>no</td>
<td>
If a href attribute is specified, the certificate is read
from the given URL.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>
Each <x509> element can either contain the X.509 certificate(s) in the
body of the element OR be referenced by the href attribute. The href
has higher prescedence.
</p>
</subsection>
<subsection name="Example XML">
<p>
The following example block.xml demonstrates the inclusion of three blocks within another enclosing block. In this example, the common shared API (containing service interfaces classes is declared in the containing block classloader).
</p>
<source><![CDATA[
<certificates>
<x509 href="http://niclas.hedhman.org/certs/signature.x509" />
</certificates>
]]></source>
</subsection>
</section>
</body>
</document>
1.1 avalon/merlin/platform/xdocs/meta/block/classloader/grant/permission/action.xml
Index: action.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<header>
<title>Action Directive</title>
<authors>
<person name="Stephen McConnell" email="mcconnell@apache.org"/>
<person name="Niclas Hedhman" email="niclas@hedhman.org"/>
</authors>
</header>
<body>
<section name="Action Directive">
<subsection name="Description">
<p>
Multiple actions may be contained within the scope of a permission.
Each action contains a single value.
</p>
</subsection>
<subsection name="Example XML">
<source><![CDATA[
<grant>
<permission class="java.io.FilePermission" name="org.apache.*" >
<action>read</action>
<action>write</action>
</permission>
</grant>
]]></source>
</subsection>
</section>
</body>
</document>
1.1 avalon/merlin/platform/xdocs/meta/block/classloader/grant/permission/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<header>
<title>Permission Directive</title>
<authors>
<person name="Stephen McConnell" email="mcconnell@apache.org"/>
<person name="Niclas Hedhman" email="niclas@hedhman.org"/>
</authors>
</header>
<body>
<section name="Permission Directive">
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Occurance</th><th>Description</th></tr>
<tr>
<td><a href="action.html">action</a></td><td>0..n</td>
<td>
The action descriptor.
</td>
</tr>
</table>
</subsection>
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>class</td><td>yes</td>
<td>
The name of the Permission class. This classname must be a subclass of
the java.security.Permission class.
</td>
</tr>
<tr>
<td>name</td><td>no</td>
<td>
This is the first argument passed into the constructor. Most Permission
classes calls this the "name" argument, but the has other names
for certain permission classes, e.g. FilePermission calls it "path".
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>
Declaration of a permission requested by the container to its parent and grnated provisionally to the components defined within the scope of the container.
</p>
</subsection>
<subsection name="Example XML">
<source><![CDATA[
<permission class="java.lang.RuntimePermission" name="getClassLoader" />
<permission class="java.util.PropertyPermission" name="java.*" >
<action>read</action>
</permission>
<permission class="java.util.PropertyPermission" name="org.apache.*" >
<action>read</action>
<action>write</action>
</permission>
]]></source>
</subsection>
</section>
</body>
</document>
1.1 avalon/merlin/platform/xdocs/meta/block/classloader/grant/permission/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright 2004 Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<project>
<title>Merlin</title>
<body>
<links>
<item name="Apache" href="http://apache.org/"/>
<item name="Avalon" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/product/framework/"/>
<item name="Containers" href="http://avalon.apache.org/product/containers/"/>
<item name="Components" href="http://avalon.apache.org/product/components/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="block.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html">
<item name="classpath" href="/meta/block/classloader/classpath/index.html"/>
<item name="library" href="/meta/block/classloader/extensions.html"/>
<item name="grant" href="/meta/block/classloader/grant/index.html">
<item name="permission" href="/meta/block/classloader/grant/permission/index.html">
<item name="action" href="/meta/block/classloader/grant/permission/action.html"/>
</item>
<item name="certificates" href="/meta/block/classloader/grant/certificates/index.html"/>
</item>
</item>
<item name="component" href="/meta/block/components/index.html"/>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
</menu>
<menu name="Resources">
<item name="Javadoc" href="/api/index.html"/>
<item name="Download" href="/resources/download.html"/>
<item name="Roadmap" href="/resources/roadmap/index.html"/>
<item name="DPML" href="/dpml/index.html"/>
</menu>
<menu name="Related Projects">
<item name="Meta" href="http://avalon.apache.org/meta"/>
<item name="Utilities" href="http://avalon.apache.org/util"/>
<item name="Repository" href="http://avalon.apache.org/repository"/>
</menu>
</body>
</project>
---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@avalon.apache.org
For additional commands, e-mail: cvs-help@avalon.apache.org