Differences between revisions 14 and 15
Revision 14 as of 2006-10-02 18:15:05
Size: 8181
Editor: LauraStewart
Comment:
Revision 15 as of 2009-09-20 22:11:13
Size: 8215
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
This page is for reviewing the 10.2 [http://db.apache.org/derby/manuals/index.html#latest ''Derby Developers Guide'']. This page is for reviewing the 10.2 [[http://db.apache.org/derby/manuals/index.html#latest|''Derby Developers Guide'']].
Line 3: Line 3:
''This page just has initial Section Summary and Sub Section Details set up. The [http://wiki.apache.org/db-derby/GettingStartedTenTwo/ReferenceManualTenTwo Reference Manual] has a complete review setup.'' ''This page just has initial Section Summary and Sub Section Details set up. The [[http://wiki.apache.org/db-derby/GettingStartedTenTwo/ReferenceManualTenTwo|Reference Manual]] has a complete review setup.''
Line 9: Line 9:
||[#upgrades Upgrades] ||Sunitha ||review done for first half of book,posted mail to the derby dev with subject 'Dev guide: sections - upgrades to controlling derby application behavior.'[http://www.nabble.com/Dev-guide%3A-sections---upgrades-to-controlling-derby-application-behavior.-p6110021.html] ||
||[#jdbcapps JDBC applications and Derby basics] ||Sunitha ||review done ||
||[#afterinstall After installing] ||Sunitha ||review done ||
||[#embeddedbasics Derby embedded basics] ||Sunitha ||review done ||
||[#deployapps Deploying Derby applications] ||Sunitha ||review done ||
||[#serverside Derby server-side programming] ||Sunitha ||review done ||
||[#controlapps Controlling Derby application behavior] ||Sunitha || review done||
||[#j2eerm Using Derby as a J2EE resource manager] || Deepa || review done||
||[#security Derby and Security] || Deepa || review done||
||[#developwithide Developing tools and using Derby with an IDE] || Deepa || review done||
||[#sqltips SQL tips] || Deepa || review done||
||[#localizing Localizing Derby] || Deepa || review done||
||[#standards Derby and standards] || Deepa || review done||
||[[#upgrades|Upgrades]] ||Sunitha ||review done for first half of book,posted mail to the derby dev with subject 'Dev guide: sections - upgrades to controlling derby application behavior.'[[http://www.nabble.com/Dev-guide%3A-sections---upgrades-to-controlling-derby-application-behavior.-p6110021.html]] ||
||[[#jdbcapps|JDBC applications and Derby basics]] ||Sunitha ||review done ||
||[[#afterinstall|After installing]] ||Sunitha ||review done ||
||[[#embeddedbasics|Derby embedded basics]] ||Sunitha ||review done ||
||[[#deployapps|Deploying Derby applications]] ||Sunitha ||review done ||
||[[#serverside|Derby server-side programming]] ||Sunitha ||review done ||
||[[#controlapps|Controlling Derby application behavior]] ||Sunitha || review done||
||[[#j2eerm|Using Derby as a J2EE resource manager]] || Deepa || review done||
||[[#security|Derby and Security]] || Deepa || review done||
||[[#developwithide|Developing tools and using Derby with an IDE]] || Deepa || review done||
||[[#sqltips|SQL tips]] || Deepa || review done||
||[[#localizing|Localizing Derby]] || Deepa || review done||
||[[#standards|Derby and standards]] || Deepa || review done||
Line 25: Line 25:
As you spot issues please add specific comments to the tables below, paying attention to the [http://wiki.apache.org/db-derby/TenTwoDocReview guidelines]. For very extensive comments, please post to derby-dev or Jira instead, then include the URL in the Comment field. As you spot issues please add specific comments to the tables below, paying attention to the [[http://wiki.apache.org/db-derby/TenTwoDocReview|guidelines]]. For very extensive comments, please post to derby-dev or Jira instead, then include the URL in the Comment field.
Line 27: Line 27:
[[Anchor(upgrades)]]''' Upgrades:''' <<Anchor(upgrades)>>''' Upgrades:'''
Line 31: Line 31:
[[Anchor(jdbcapps)]]''' JDBC applications and Derby basics:''' <<Anchor(jdbcapps)>>''' JDBC applications and Derby basics:'''
Line 35: Line 35:
[[Anchor(afterinstall)]]''' After installing:''' <<Anchor(afterinstall)>>''' After installing:'''
Line 39: Line 39:
[[Anchor(embeddedbasics)]]''' Derby embedded basics:''' <<Anchor(embeddedbasics)>>''' Derby embedded basics:'''
Line 43: Line 43:
[[Anchor(deployapps)]]''' Deploying Derby applications:''' <<Anchor(deployapps)>>''' Deploying Derby applications:'''
Line 47: Line 47:
[[Anchor(serverside)]]''' Derby server-side programming:''' <<Anchor(serverside)>>''' Derby server-side programming:'''
Line 51: Line 51:
[[Anchor(controlapps)]]''' Controlling Derby application behavior:''' <<Anchor(controlapps)>>''' Controlling Derby application behavior:'''
Line 55: Line 55:
[[Anchor(j2eerm)]]''' Using Derby as a J2EE resource manager:''' <<Anchor(j2eerm)>>''' Using Derby as a J2EE resource manager:'''
Line 60: Line 60:
[[Anchor(security)]]''' Derby and Security:''' <<Anchor(security)>>''' Derby and Security:'''
Line 71: Line 71:
[[Anchor(developwithide)]]''' Developing tools and using Derby with an IDE:''' <<Anchor(developwithide)>>''' Developing tools and using Derby with an IDE:'''
Line 75: Line 75:
[[Anchor(sqltips)]]''' SQL Tips:''' <<Anchor(sqltips)>>''' SQL Tips:'''
Line 79: Line 79:
[[Anchor(localizing)]]''' Localizing Derby:''' <<Anchor(localizing)>>''' Localizing Derby:'''
Line 83: Line 83:
[[Anchor(standards)]]''' Derby and standards:''' <<Anchor(standards)>>''' Derby and standards:'''

This page is for reviewing the 10.2 ''Derby Developers Guide''.

This page just has initial Section Summary and Sub Section Details set up. The Reference Manual has a complete review setup.

Section Summary

Please list the sections you intend to review in the summary table below:

Section Name

Reviewers

Status

Upgrades

Sunitha

review done for first half of book,posted mail to the derby dev with subject 'Dev guide: sections - upgrades to controlling derby application behavior.'http://www.nabble.com/Dev-guide%3A-sections---upgrades-to-controlling-derby-application-behavior.-p6110021.html

JDBC applications and Derby basics

Sunitha

review done

After installing

Sunitha

review done

Derby embedded basics

Sunitha

review done

Deploying Derby applications

Sunitha

review done

Derby server-side programming

Sunitha

review done

Controlling Derby application behavior

Sunitha

review done

Using Derby as a J2EE resource manager

Deepa

review done

Derby and Security

Deepa

review done

Developing tools and using Derby with an IDE

Deepa

review done

SQL tips

Deepa

review done

Localizing Derby

Deepa

review done

Derby and standards

Deepa

review done

Sub Section Details

As you spot issues please add specific comments to the tables below, paying attention to the guidelines. For very extensive comments, please post to derby-dev or Jira instead, then include the URL in the Comment field.

Upgrades:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Sunitha

http://www.nabble.com/Dev-guide%3A-sections---upgrades-to-controlling-derby-application-behavior.-p6110021.html

Fixed (Laura)

JDBC applications and Derby basics:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Sunitha

http://www.nabble.com/Dev-guide%3A-sections---upgrades-to-controlling-derby-application-behavior.-p6110021.html

Fixed (Laura)

After installing:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Sunitha

http://www.nabble.com/Dev-guide%3A-sections---upgrades-to-controlling-derby-application-behavior.-p6110021.html

Fixed (Laura)

Derby embedded basics:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Sunitha

http://www.nabble.com/Dev-guide%3A-sections---upgrades-to-controlling-derby-application-behavior.-p6110021.html

Fixed (Laura)

Deploying Derby applications:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Sunitha

http://www.nabble.com/Dev-guide%3A-sections---upgrades-to-controlling-derby-application-behavior.-p6110021.html

Fixed (Laura)

Derby server-side programming:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Sunitha

http://www.nabble.com/Dev-guide%3A-sections---upgrades-to-controlling-derby-application-behavior.-p6110021.html

Fixed (Laura)

Controlling Derby application behavior:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Sunitha

http://www.nabble.com/Dev-guide%3A-sections---upgrades-to-controlling-derby-application-behavior.-p6110021.html

Fixed (Laura)

Using Derby as a J2EE resource manager:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Getting a DataSource

http://db.apache.org/derby/docs/dev/devguide/cdevresman89722.html

Deepa

"XADataSource.getXAConection() method" and "XADataSource.getXAConnection().getConnection() method" should be changed to more general "getConnection method of data source object."

Fixed (Laura)

Derby and Security:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Built-in Derby users

http://db.apache.org/derby/docs/dev/devguide/cdevcsecure21547.html

Deepa

To keep the terminology consistent, "These user names are case-sensitive for user authorization" should be changed to "These user names are case-sensitive for user authentication".

Fixed (Laura)

Notes on the Derby security features

http://db.apache.org/derby/docs/dev/devguide/cdevcsecure10983.html

Deepa

This statement should be removed "Because Derby does not support traditional grant and revoke features, the security model has some basic limitations." as grant/revoke is supported now. I think the following two lines "For both embedded and client/server systems, it assumes that users are trusted. You must trust your full-access users not to perform undesirable actions." can also be removed.

Fixed (Laura)

JNDI-specific properties for external directory services

http://db.apache.org/derby/docs/dev/devguide/cdevcsecure864242.html

Deepa

"Java Naming and Direction" should be changed to "Java Naming and Directory".

Fixed (Laura)

Example of setting a user-defined class

http://db.apache.org/derby/docs/dev/devguide/rdevexudclass.html

Deepa

The interface specified in the following line "A very simple example of a class that implements the org.apache.derby.authentication interface." must be "org.apache.derby.authentication.UserAuthenticator interface".

Fixed (Laura)

Example of setting a user-defined class

http://db.apache.org/derby/docs/dev/devguide/rdevexudclass.html

Deepa

In the first comment in the code example, "derby.connection.specificAuthentication" property is not the right name. It must be changed to "derby.authentication.provider".

Fixed (Laura)

List of user-authentication properties

http://db.apache.org/derby/docs/dev/devguide/rdevcsecure557.html

Deepa

Formatting and case of property names is not consistent.

Fixed (Laura)

User authorizations

http://db.apache.org/derby/docs/dev/devguide/cdevcsecure36595.html

Deepa

Sub-section titled "Changes to connection authorization settings" can be changed to "Changes to user authorization settings" as it applies to both SQL and connection authorization.

Didn't change this since the section is about connection authorization (Laura)

Encrypting an existing unencrypted database

http://db.apache.org/derby/docs/dev/devguide/tdevcsecureunencrypteddb.html

Deepa

minor typos. Must be "encrypted" instead of "encryped". "For encrypting an existing unencrypted database:" instead of "To encrypting an existing unencrypted database:"

Fixed (Laura)

Developing tools and using Derby with an IDE:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

SQL Tips:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Localizing Derby:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

Derby and standards:

Sub Section

HTML Url or PDF Page

Reviewer

Comment

Resolution

DeveloperGuideTenTwo (last edited 2009-09-20 22:11:13 by localhost)