db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chaa...@apache.org
Subject svn commit: r1064226 - in /db/derby/docs/trunk/src: devguide/cdevbabejgjd.dita devguide/cdevcbabejdfj.dita ref/refderby.ditamap ref/rrefjdbc4_0summary.dita ref/rrefjdbc4_1connection.dita ref/rrefjdbc4_1summary.dita
Date Thu, 27 Jan 2011 17:43:48 GMT
Author: chaase3
Date: Thu Jan 27 17:43:48 2011
New Revision: 1064226

URL: http://svn.apache.org/viewvc?rev=1064226&view=rev
Log:
DERBY-4978: Document the new SQLPermission required by the JDBC 4.1 Connection.abort(Executor)
method

Modified 2 Dev Guide files and 1 Ref Manual file; added 2 new Ref Manual files and modified
map.

Patches: DERBY-4978-2.diff

Added:
    db/derby/docs/trunk/src/ref/rrefjdbc4_1connection.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefjdbc4_1summary.dita   (with props)
Modified:
    db/derby/docs/trunk/src/devguide/cdevbabejgjd.dita
    db/derby/docs/trunk/src/devguide/cdevcbabejdfj.dita
    db/derby/docs/trunk/src/ref/refderby.ditamap
    db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita

Modified: db/derby/docs/trunk/src/devguide/cdevbabejgjd.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevbabejgjd.dita?rev=1064226&r1=1064225&r2=1064226&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevbabejgjd.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevbabejgjd.dita Thu Jan 27 17:43:48 2011
@@ -29,8 +29,8 @@ conref="../conrefs.dita#prod/productshor
 </metadata></prolog>
 <conbody>
 <p>See Default Policy Implementation and Policy File Syntax at <xref format="html"
-href="http://java.sun.com/j2se/1.4.2/docs/guide/security/PolicyFiles.html"
-scope="external">http://java.sun.com/j2se/1.4.2/docs/guide/security/PolicyFiles.html</xref>
for
+href="http://download.oracle.com/javase/1.4.2/docs/guide/security/PolicyFiles.html"
+scope="external">http://download.oracle.com/javase/1.4.2/docs/guide/security/PolicyFiles.html</xref>
for
 more information about creating policy files.</p>
 <section><title>Mandatory permissions</title><dl><dlentry>
 <dt>permission java.lang.RuntimePermission createClassLoader</dt>
@@ -129,8 +129,17 @@ or the JMX Instrumentation and Agent Spe
 </dd>
 </dlentry><dlentry>
 <dt>permission javax.management.MBeanTrustPermission "register";</dt>
-<dd>Trusts Derby code to be the source of MBeans and to register these in 
-the MBean server.</dd>
+<dd>Trusts <ph conref="../conrefs.dita#prod/productshortname"></ph> code
to be
+the source of MBeans and to register these in the MBean server.</dd>
+</dlentry><dlentry>
+<dt>permission java.sql.SQLPermission "callAbort";</dt>
+<dd>Allows <ph conref="../conrefs.dita#prod/productshortname"></ph> code
to call
+the <codeph>java.sql.Connection.abort</codeph> method. This permission must be
+granted both to the <ph conref="../conrefs.dita#prod/productshortname"></ph>
+JDBC driver (by granting it to <codeph>derby.jar</codeph> and
+<codeph>derbyclient.jar</codeph>) and to the application code that calls
+<codeph>Connection.abort()</codeph>. Do not grant this permission to application
+code unless you are certain that only superusers can invoke the code.</dd>
 </dlentry>
 </dl> </section>
 <section><title>Combining permissions</title><p>You might grant one
<i>FilePermission</i> that

Modified: db/derby/docs/trunk/src/devguide/cdevcbabejdfj.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevcbabejdfj.dita?rev=1064226&r1=1064225&r2=1064226&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevcbabejdfj.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevcbabejdfj.dita Thu Jan 27 17:43:48 2011
@@ -24,12 +24,14 @@ to execute and access database files.</s
 <prolog><metadata>
 <keywords>
 <indexterm>Policy files<indexterm>and Derby permissions</indexterm></indexterm>
-<indexterm>Java 2 Security Manager</indexterm>
+<indexterm>Java SE Security Manager</indexterm>
 </keywords>
 </metadata>
 </prolog>
 <conbody>
 <p>For more information about permissions and examples of creating permission
 objects and granting permissions, see the Security Architecture specification
-at <synph><var>http://java.sun.com/j2se/1.4.2/docs/guide/security/PolicyFiles.html</var></synph>.</p>
+at <xref format="html" 
+href="http://download.oracle.com/javase/1.4.2/docs/guide/security/PolicyFiles.html"
+scope="external">http://download.oracle.com/javase/1.4.2/docs/guide/security/PolicyFiles.html</xref>.</p>
 </conbody></concept>

Modified: db/derby/docs/trunk/src/ref/refderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/refderby.ditamap?rev=1064226&r1=1064225&r2=1064226&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/refderby.ditamap (original)
+++ db/derby/docs/trunk/src/ref/refderby.ditamap Thu Jan 27 17:43:48 2011
@@ -593,7 +593,7 @@ URL syntax"></topicref>
 </topicref>
 <topicref href="rrefjdbcjsr169.dita" navtitle="JDBC Package for Connected Device Configuration/Foundation
Profile
 (JSR169)"></topicref>
-<topicref collection-type="family" href="rrefjdbc4_0summary.dita" navtitle="JDBC 4.0-only
features ">
+<topicref collection-type="family" href="rrefjdbc4_0summary.dita" navtitle="JDBC 4.0 and
4.1 features ">
 <topicref href="rrefjdbc4_0sqlexception.dita" navtitle="Refined subclasses of SQLException">
 </topicref>
 <topicref href="rrefjdbc4_0connection.dita" navtitle="java.sql.Connection interface: JDBC
4.0 features">
@@ -607,6 +607,10 @@ URL syntax"></topicref>
 <topicref href="rrefjdbcrefsqlxml.dita" navtitle="java.sql.SQLXML interface">
 </topicref>
 </topicref>
+<topicref collection-type="family" href="rrefjdbc4_1summary.dita" navtitle="JDBC 4.1-only
features ">
+<topicref href="rrefjdbc4_1connection.dita" navtitle="java.sql.Connection interface: JDBC
4.1 features">
+</topicref>
+</topicref>
 <topicref collection-type="family" href="rrefjdbc1020262.dita" navtitle="JDBC escape syntax
">
 <topicref href="rrefjdbc70824.dita" navtitle="JDBC escape keyword for call statements">
 </topicref>

Modified: db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita?rev=1064226&r1=1064225&r2=1064226&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefjdbc4_0summary.dita Thu Jan 27 17:43:48 2011
@@ -19,10 +19,11 @@ limitations under the License.
 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
  "../dtd/reference.dtd">
 <reference id="rrefjdbc4_0summary" xml:lang="en-us">
-<title>JDBC 4.0-only features </title>
+<title>JDBC 4.0 and 4.1 features</title>
 <prolog><metadata>
 <keywords>
 <indexterm>JDBC 4.0</indexterm>
+<indexterm>JDBC 4.1</indexterm>
 <indexterm>Ease of development</indexterm>
 <indexterm>Driver autoloading</indexterm>
 <indexterm>SQLException subclasses</indexterm>
@@ -38,6 +39,9 @@ limitations under the License.
 JDBC 4.0 adds some functionality to the core API. This section
 documents the features supported by <ph conref="../conrefs.dita#prod/productshortname"></ph>.
 </p>
+<p>All these JDBC 4.0 features are also supported by JDBC 4.1. See
+<xref href="rrefjdbc4_1summary.dita#rrefjdbc4_1summary"></xref> for information
+about features supported only by JDBC 4.1.</p>
 <p><note>These features are present only in a JDK 6 or higher
 environment.
 </note></p>

Added: db/derby/docs/trunk/src/ref/rrefjdbc4_1connection.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc4_1connection.dita?rev=1064226&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc4_1connection.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefjdbc4_1connection.dita Thu Jan 27 17:43:48 2011
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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.
+-->
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefjdbc4_1connection" xml:lang="en-us">
+<title>java.sql.Connection interface: JDBC 4.1 features</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Connection interface</indexterm>
+<indexterm>abort method<indexterm>Connection interface</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section>
+<p>
+JDBC 4.1 adds new features to the <i>Connection</i> interface:
+</p>
+<ul>
+<li><b>Aborting connections</b> - The <i>abort(Executor)</i>
method aborts
+a running connection. Outstanding transactional work is rolled back, and the
+physical connection to the database is destroyed. When running under a Java
+<i>SecurityManager</i>, this method can be called only if
+<i>SQLPermission("callAbort")</i> has been granted both to the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> JDBC driver (in
+<i>derby.jar</i> and <i>derbyclient.jar</i>) and to the
+application code that calls <i>Connection.abort()</i>. For security reasons,
+permission to execute this method should not be granted lightly. Do not grant
+this permission to application code unless you are certain that only superusers
+can invoke the code. For more information, see "Granting permissions to 
+<ph conref="../conrefs.dita#prod/productshortname"></ph>" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>.</li>
+</ul>
+</section>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefjdbc4_1connection.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefjdbc4_1summary.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbc4_1summary.dita?rev=1064226&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbc4_1summary.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefjdbc4_1summary.dita Thu Jan 27 17:43:48 2011
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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.
+-->
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefjdbc4_1summary" xml:lang="en-us">
+<title>JDBC 4.1-only features</title>
+<prolog><metadata>
+<keywords>
+<indexterm>JDBC 4.1</indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section>
+<p>JDBC 4.1 adds some functionality to the core API. This section
+documents the JDBC 4.1 features supported by
+<ph conref="../conrefs.dita#prod/productshortname"></ph>.</p>
+<p>For information on features supported by both JDBC 4.0 and JDBC 4.1, see
+<xref href="rrefjdbc4_0summary.dita#rrefjdbc4_0summary"></xref>.</p>
+<p><note>JDBC 4.1 features are present only in a JDK 7 or higher
+environment.</note></p>
+</section>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefjdbc4_1summary.dita
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message