Skip to content
Browse files

improve docs

  • Loading branch information...
1 parent 8b0fb54 commit 062db8243b155a70d262a845de02de29febf0dc8 @kaven276 committed Jul 20, 2012
Showing with 25 additions and 2 deletions.
  1. +14 −0 doc/coding_guide.md
  2. +1 −1 doc/deployment.md
  3. +10 −1 doc/introduction.md
View
14 doc/coding_guide.md
@@ -163,6 +163,8 @@ layers of code
==============
1. compare to J2EE
+ use
+
basic web developing
==============
@@ -179,6 +181,18 @@ get request info by r.xxx API
### get basic request line info
+ The request line is of the format http://hostname:port[/base]/dad/pack.proc/path?querystring
+
+* r.host
+* r.port
+* r.base
+* r.prog
+* r.pack
+* r.proc
+* r.path
+* r.qstr
+
+
### get form submit info
Html form can submit using get or post methods, PSP.WEB can accept them both.
View
2 doc/deployment.md
@@ -11,7 +11,7 @@ Install at oracle's side
## Install PSP.WEB engine schema objects and demo schema objects.
- Change working directory into oracle, use sqlplus to login into the target oracle database as sysdba, then execute install.sql script file. Example like this:
+ Change working directory into oracle subdir of this project, use sqlplus to login into the target oracle database as sysdba, then execute install.sql script file. Example like this:
sqlplus "sys/password@targetdb as sysdba"
SQL> @install
View
11 doc/introduction.md
@@ -98,7 +98,7 @@ Compare to Oracle's APEX
APEX support common dynamic website design (authentication, page flow control, ...), It's a high level platform, so it's convenient, but because its lack of low level API/framework support, it limit the freedom of design. It can be used in some none official and common cases, but if your organization need a serious information system, you'd better not to use it. It's fixed bound to its UI/app design, but real requirement is much more flexible and versatile.
- APEX is design after Microsoft's Access and Oracle's forms. We known the limits of access like RAD, it' not for real programmers, and it is not for serius applications.
+ APEX is design after Microsoft's Access and Oracle's forms. We known the limits of access like RAD, it' not for real programmers, and it is not for serious applications.
The good to use PL/SQL for web is for write data processing ode in IDE like "PL/SQL Developer", intelligent code assistant is there, but when you use APEX, all the goods are lost. I's difficult to write a simple sql or pl/sql. Apex just throw away the only real valuable feature (stuck to easy data process coding) of oracle development, and trade it for the self pleased so limited wizard, predefined design patterns.
@@ -178,6 +178,15 @@ separation of files out of db
When your PSP.WEB code print a,link,form,script,iframe,frame..., the url of the linked file is re-allocable by just configuration, and PSP.WEB let you use shortest string to specify the url by convention.
+Leverage result cache
+-----------------------
+
+ No-in-db platform or app server can cache data from database, but integrity is not ensured. With ORACLE, we can take the feature of result-cache, so often used data can just cache in database, the PL/SQL will got fresh data surely.
+
+ But ORACLE's result cache will invalidate after the table change, if one row changed, all result cache related to the table will invalidate, so it's too limiting.
+
+ So we invent a version based cache, we place result cache data onto package variables, every result cache data will have a version parameter and it will never invalided for its version, if the cache changed, the version store in GAC (global application context) that's identified by key is change.
+
Other Docs and references
============

0 comments on commit 062db82

Please sign in to comment.
Something went wrong with that request. Please try again.