bknr-cvs January 2006

bknr-cvs@common-lisp.net

2 participants
27 discussions

[Bknr-cvs] r1809 - in trunk/projects/bknr-website: . pdf
by bknr＠bknr.net 25 Jan '06

25 Jan '06

Author: hhubner Date: 2006-01-24 23:41:06 -0600 (Tue, 24 Jan 2006) New Revision: 1809 Added: trunk/projects/bknr-website/CAUTION trunk/projects/bknr-website/index.html trunk/projects/bknr-website/pdf/ trunk/projects/bknr-website/pdf/datastore-manual.pdf trunk/projects/bknr-website/pdf/js-manual.pdf trunk/projects/bknr-website/pdf/js-reference.pdf Modified: trunk/projects/bknr-website/ Log: Prepare for website maintenance through Subversion. Property changes on: trunk/projects/bknr-website ___________________________________________________________________ Name: svn:ignore + snapshots packages html Added: trunk/projects/bknr-website/CAUTION =================================================================== --- trunk/projects/bknr-website/CAUTION 2006-01-24 20:53:19 UTC (rev 1808) +++ trunk/projects/bknr-website/CAUTION 2006-01-25 05:41:06 UTC (rev 1809) @@ -0,0 +1,3 @@ +Note: This directory is a subversion checkout. To add or edit the web +site, use a private subversion checkout and check in. In particular, the +html is a scratch directory and should not be edited. Added: trunk/projects/bknr-website/index.html =================================================================== --- trunk/projects/bknr-website/index.html 2006-01-24 20:53:19 UTC (rev 1808) +++ trunk/projects/bknr-website/index.html 2006-01-25 05:41:06 UTC (rev 1809) @@ -0,0 +1,8 @@ +<html> + <head> + <meta http-equiv="Refresh" content="1; URL=website/templates/home.xml"/> + </head> + <body> + Redirecting to XML/XSL site. HTML site will be back in a few days. + </body> +</html> Added: trunk/projects/bknr-website/pdf/datastore-manual.pdf =================================================================== (Binary files differ) Property changes on: trunk/projects/bknr-website/pdf/datastore-manual.pdf ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/projects/bknr-website/pdf/js-manual.pdf =================================================================== (Binary files differ) Property changes on: trunk/projects/bknr-website/pdf/js-manual.pdf ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/projects/bknr-website/pdf/js-reference.pdf =================================================================== (Binary files differ) Property changes on: trunk/projects/bknr-website/pdf/js-reference.pdf ___________________________________________________________________ Name: svn:mime-type + application/octet-stream

1 0

[Bknr-cvs] r1808 - trunk/projects/bknr-website/templates
by bknr＠bknr.net 24 Jan '06

24 Jan '06

Author: hhubner Date: 2006-01-24 14:53:19 -0600 (Tue, 24 Jan 2006) New Revision: 1808 Added: trunk/projects/bknr-website/templates/generate-html.xsl Log: Creates a shell script to generate HTML pages Added: trunk/projects/bknr-website/templates/generate-html.xsl =================================================================== --- trunk/projects/bknr-website/templates/generate-html.xsl 2006-01-24 11:55:10 UTC (rev 1807) +++ trunk/projects/bknr-website/templates/generate-html.xsl 2006-01-24 20:53:19 UTC (rev 1808) @@ -0,0 +1,4 @@ +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> + <xsl:output mode="text" omit-xml-declaration="yes" /> + <xsl:template match="item">xsltproc --stringparam mode html -o ../html/<xsl:value-of select="@url"/>.html <xsl:value-of select="@url"/>.xml</xsl:template> +</xsl:stylesheet> \ No newline at end of file

1 0

[Bknr-cvs] r1807 - trunk/projects/bknr-website/src
by bknr＠bknr.net 24 Jan '06

24 Jan '06

Author: hhubner Date: 2006-01-24 05:55:10 -0600 (Tue, 24 Jan 2006) New Revision: 1807 Removed: trunk/projects/bknr-website/src/bknr-website.asd trunk/projects/bknr-website/src/config.lisp trunk/projects/bknr-website/src/handlers.lisp trunk/projects/bknr-website/src/init.lisp trunk/projects/bknr-website/src/load.lisp trunk/projects/bknr-website/src/packages.lisp trunk/projects/bknr-website/src/tags.lisp trunk/projects/bknr-website/src/webserver.lisp Log: This is no longer needed with the XSL based website Deleted: trunk/projects/bknr-website/src/bknr-website.asd =================================================================== --- trunk/projects/bknr-website/src/bknr-website.asd 2006-01-24 11:21:39 UTC (rev 1806) +++ trunk/projects/bknr-website/src/bknr-website.asd 2006-01-24 11:55:10 UTC (rev 1807) @@ -1,26 +0,0 @@ -;;;; -*- Mode: LISP -*- - -(in-package :cl-user) - -(defpackage :bknr-website.system - (:use :cl :asdf)) - -(in-package :bknr-website.system) - -(defsystem :bknr-website - :name "BKNR" - :author "Hans Huebner <hans(a)huebner.org>" - :version "0" - :maintainer "Hans Huebner <hans(a)huebner.org>" - :licence "BSD" - :description "BKNR Web Server" - :long-description "" - - :depends-on (:bknr-modules :klammerscript) - - :components ((:file "packages") - (:file "config" :depends-on ("packages")) - (:file "tags" :depends-on ("config")) - (:file "handlers" :depends-on ("config")) - (:file "webserver" :depends-on ("handlers")) - (:file "init" :depends-on ("webserver")))) Deleted: trunk/projects/bknr-website/src/config.lisp =================================================================== --- trunk/projects/bknr-website/src/config.lisp 2006-01-24 11:21:39 UTC (rev 1806) +++ trunk/projects/bknr-website/src/config.lisp 2006-01-24 11:55:10 UTC (rev 1807) @@ -1,16 +0,0 @@ -(in-package :bknr-website.config) - -;; URL für BASE HREFs -(defparameter *website-url* "http://bknr.net") - -(defparameter *root-directory* #p"home:bknr-svn/bknr-website/") - -(defparameter *store-directory* (merge-pathnames #p"datastore/" *root-directory*)) - -(defparameter *website-directory* (merge-pathnames #p"website/" *root-directory*)) - -(defparameter *webserver-port* 8082) - -(defparameter *default-mail-from* "postmaster(a)bknr.net") -(defparameter *default-mail-subject* "Mail from the BKNR Website") -(defparameter *smtp-server* "127.0.0.1") \ No newline at end of file Deleted: trunk/projects/bknr-website/src/handlers.lisp =================================================================== --- trunk/projects/bknr-website/src/handlers.lisp 2006-01-24 11:21:39 UTC (rev 1806) +++ trunk/projects/bknr-website/src/handlers.lisp 2006-01-24 11:55:10 UTC (rev 1807) @@ -1,56 +0,0 @@ -(in-package :bknr-website) - -(enable-interpol-syntax) - -(define-persistent-class pdf (blob) - ((name :read - :index-type string-unique-index - :index-reader pdf-with-name))) - -(defclass pdf-handler (object-handler) - () - (:default-initargs :class 'pdf :query-function #'pdf-with-name)) - -(defmethod handle-object ((handler pdf-handler) (pdf (eql nil)) req) - (with-bknr-page (req :title "PDF not found") - )) - -(defmethod handle-object ((handler pdf-handler) pdf req) - (with-http-response (req *ent* :content-type "application/pdf") - (with-http-body (req *ent* :external-format '(unsigned-byte 8)) - (blob-to-stream pdf net.html.generator:*html-stream*)))) - -(defclass upload-pdf-handler (page-handler) - ()) - -(defmethod handle ((handler upload-pdf-handler) req) - (case (request-method req) - (:get - (with-bknr-page (req :title "Upload a PDF file") - (html - ((:form :method "post" :enctype "multipart/form-data") - "Upload your file: " ((:input :type "file" :name "upload")) - (submit-button "upload" "upload"))))) - (:post - (with-bknr-page (req :title "Upload PDF file results") - (let* ((file-name (request-uploaded-file *req* "upload")) - (name (pathname-name file-name))) - (cond - ((pdf-with-name name) - (html (:h1 "Duplicate name") - "A PDF document with this name already exists")) - ((with-open-file (pdf file-name) - (not (cl-ppcre:scan "^%PDF-" (read-line pdf)))) - (html (:h1 "Invalid uploaded document") - "The uploaded document does not appear to be a PDF file")) - (t - (let ((pdf (make-blob-from-file file-name 'pdf :name name))) - (html (:h1 "Upload successful") - "Your upload was successful. The URL of your PDF file is " - ((:a :href (format nil "/pdf/~A" (store-object-id pdf))) - (:princ-safe (format nil "/pdf/~A" (store-object-id pdf))) ".")))))))))) - - -(define-bknr-webserver-module pdf - ("/upload-pdf" upload-pdf-handler) - ("/pdf" pdf-handler)) Deleted: trunk/projects/bknr-website/src/init.lisp =================================================================== --- trunk/projects/bknr-website/src/init.lisp 2006-01-24 11:21:39 UTC (rev 1806) +++ trunk/projects/bknr-website/src/init.lisp 2006-01-24 11:55:10 UTC (rev 1807) @@ -1,18 +0,0 @@ -(in-package :bknr-website) - -(defun startup () - (when *store* - (close-store)) - (make-instance 'store - :directory *store-directory* - :subsystems (list (make-instance 'store-object-subsystem) - (make-instance 'blob-subsystem - :n-blobs-per-directory 1000))) - (unless (find-user "anonymous") - (make-user "anonymous") ; used for all anonymous sessions - (make-user "admin" :password "admin" :full-name "Administrator" :flags '(:admin)) - (import-image "bknr-logo.png" :keywords '(:banner :bknr))) - - (bknr.cron:start-cron) - - (publish-bknr-website)) Deleted: trunk/projects/bknr-website/src/load.lisp =================================================================== --- trunk/projects/bknr-website/src/load.lisp 2006-01-24 11:21:39 UTC (rev 1806) +++ trunk/projects/bknr-website/src/load.lisp 2006-01-24 11:55:10 UTC (rev 1807) @@ -1,9 +0,0 @@ -(push :cl-gd-gif *features*) - -(asdf:oos 'asdf:load-op :bknr-website) -(asdf:oos 'asdf:load-op :swank) - -(ignore-errors (swank::create-swank-server 4005 :spawn #'swank::simple-announce-function t)) -(bknr-website::startup) - -(mp::startup-idle-and-top-level-loops) Deleted: trunk/projects/bknr-website/src/packages.lisp =================================================================== --- trunk/projects/bknr-website/src/packages.lisp 2006-01-24 11:21:39 UTC (rev 1806) +++ trunk/projects/bknr-website/src/packages.lisp 2006-01-24 11:55:10 UTC (rev 1807) @@ -1,57 +0,0 @@ -(in-package :cl-user) - -(defpackage :bknr-website.config - (:use :cl - :cl-user) - (:export #:*website-url* - #:*website-directory* - #:*webserver-port* - #:*store-directory* - #:*default-mail-from* - #:*default-mail-subject* - #:*smtp-server*)) - -(defpackage :bknr-website.imageproc - (:use :cl - :cl-user - :bknr.web - :cl-gd - :bknr-website.config) - (:export)) - -(defpackage :bknr-website - (:use :cl - :cl-user - :ext - :cl-interpol - :cl-ppcre - :bknr.utils - :bknr.web - :bknr.datastore - :bknr.indices - :bknr.user - :bknr.images - :bknr-website.config - :net.aserve - :net.post-office - :xhtml-generator - :js) - (:shadowing-import-from :cl-interpol #:quote-meta-chars) - (:export )) - -(defpackage :bknr-website.tags - (:use :cl - :cl-user - :ext - :bknr.web - :bknr.utils - :bknr.datastore - :bknr.user - :bknr.images - :net.aserve - :xhtml-generator - :bknr-website.config - :bknr-website) - (:shadowing-import-from :cl-interpol #:quote-meta-chars) - (:shadowing-import-from :acl-compat.mp #:process-kill #:process-wait) - (:export #:hello)) \ No newline at end of file Deleted: trunk/projects/bknr-website/src/tags.lisp =================================================================== --- trunk/projects/bknr-website/src/tags.lisp 2006-01-24 11:21:39 UTC (rev 1806) +++ trunk/projects/bknr-website/src/tags.lisp 2006-01-24 11:55:10 UTC (rev 1807) @@ -1,41 +0,0 @@ -(in-package :bknr-website.tags) - -(defun object-to-template-vars (object) - (dolist (slot-name (mapcar #'mop:slot-definition-name (mop:class-slots (class-of object)))) - (when (and (slot-boundp object slot-name) - (slot-value object slot-name)) - (setf (get-template-var (make-keyword-from-string (symbol-name slot-name))) - (format nil "~A" (slot-value object slot-name)))))) - -(defun format-object-id (format object &rest args) - (apply #'format nil format (store-object-id object) args)) - -(define-bknr-tag login-widget () - (let ((user (bknr-request-user *req*))) - (cond - ((anonymous-p user) - (when (query-param *req* "__username") - (html ((:div :id "logfail") "Login failed"))) - (html ((:form :method "post") - "Login" :br - ((:input :type "text" :name "__username")) - "Password" :br - ((:input :type "password" :name "__password")) - ((:button :type "submit" :name "action" :value "login") "login")))) - (t - (html ((:form :method "post" :action "/logout") - ((:input :type "hidden" :name "url" :value (puri:uri-path (request-uri *req*)))) - (:div "Logged in as " :br - ((:a :href (format-object-id "/user/~A" user)) - (:princ-safe (user-full-name user)))) - (:div ((:button :type "submit" :name "action" :value "logout") "logout")))))))) - -(defun object-from-request () - (find-store-object (parse-integer (get-template-var :*path-arg*)))) - -(define-bknr-tag load-argument-object (&key children) - (let* ((object (object-from-request))) - (object-to-template-vars object) - (setf (get-template-var :object-id) (store-object-id object)) - (mapc #'emit-template-node children))) - Deleted: trunk/projects/bknr-website/src/webserver.lisp =================================================================== --- trunk/projects/bknr-website/src/webserver.lisp 2006-01-24 11:21:39 UTC (rev 1806) +++ trunk/projects/bknr-website/src/webserver.lisp 2006-01-24 11:55:10 UTC (rev 1807) @@ -1,43 +0,0 @@ -(in-package :bknr-website) - -(enable-interpol-syntax) - -;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; -;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; - -(defun make-daily-statistics () - (bknr.stats::make-yesterdays-stats :delete-events t :remove-referer-hosts '("bknr-website.bknr.net"))) - -(defun publish-bknr-website (&key (port *webserver-port*) (listeners 20)) - - (unless (bknr.cron:cron-job-with-name "daily webserver statistics") - (bknr.cron:make-cron-job "daily webserver statistics" 'make-daily-statistics - 1 0 :every :every)) - - (make-instance 'website - :name "LISP ECOOP 2005 CMS" - :handler-definitions `(("/" redirect-handler - :to "/home") - ("/" template-handler - :destination ,(namestring (merge-pathnames #p"templates/" *website-directory*)) - :command-packages ((:bknr-website . :bknr-website.tags) - (:bknr . :bknr.web) - (:menu . :bknr.site-menu))) - ("/static" directory-handler - :destination ,(unix-namestring (merge-pathnames #p"static/" *website-directory*)))) - :modules '(user images stats mailinglist mailinglist-registration pdf) - - :admin-navigation '(("user" . "/user/") - ("stats" . "/stats") - ("post mailinglists" . "/post-mailinglist") - ("logout" . "/logout")) - - :authorizer (make-instance 'bknr-authorizer) - :style-sheet-urls '("/static/styles.css") - :javascript-urls '("/static/javascript.js")) - - (publish-file :path "/snapshots/bknr.tar.bz2" :file "/home/bknr/bknr-snapshot.tar.bz2" :content-type "application/binary") - (publish-file :path "/snapshots/bknr-thirdparty.tar.bz2" :file "/home/bknr/bknr-thirdparty.tar.bz2" :content-type "application/binary") - - - (start :port port :listeners listeners))

1 0

[Bknr-cvs] r1806 - trunk/projects/bknr-website/templates
by bknr＠bknr.net 24 Jan '06

24 Jan '06

Author: hhubner Date: 2006-01-24 05:21:39 -0600 (Tue, 24 Jan 2006) New Revision: 1806 Modified: trunk/projects/bknr-website/templates/documentation.xml Log: Fix documentation paths. Modified: trunk/projects/bknr-website/templates/documentation.xml =================================================================== --- trunk/projects/bknr-website/templates/documentation.xml 2006-01-24 11:18:11 UTC (rev 1805) +++ trunk/projects/bknr-website/templates/documentation.xml 2006-01-24 11:21:39 UTC (rev 1806) @@ -7,12 +7,12 @@ <ul> - <li>The <a href="/pdf/datastore-manual" target="bknr_pdf">datastore + <li>The <a href="../../pdf/datastore-manual" target="bknr_pdf">datastore manual</a> describes the persistence mechanism including the CLOS-based indexing facility</li> - <li>The KlammerScript <a href="/pdf/js-manual" - target="bknr_pdf">manual</a> and <a href="/pdf/js-reference" + <li>The KlammerScript <a href="../../pdf/js-manual" + target="bknr_pdf">manual</a> and <a href="../../pdf/js-reference" target="bknr_pdf">reference</a> describe the Lisp to Javascript converter</li>

1 0

[Bknr-cvs] r1805 - trunk/projects/bknr-website/templates
by bknr＠bknr.net 24 Jan '06

24 Jan '06

Author: hhubner Date: 2006-01-24 05:18:11 -0600 (Tue, 24 Jan 2006) New Revision: 1805 Modified: trunk/projects/bknr-website/templates/bknr.xsl Log: Fix image path Modified: trunk/projects/bknr-website/templates/bknr.xsl =================================================================== --- trunk/projects/bknr-website/templates/bknr.xsl 2006-01-24 11:14:49 UTC (rev 1804) +++ trunk/projects/bknr-website/templates/bknr.xsl 2006-01-24 11:18:11 UTC (rev 1805) @@ -23,7 +23,7 @@ <div id="title">BKNR Lisp Application Environment</div> <div id="logo"> <a href="http://bknr.net/" target="_new"> - <img width="88" height="31" alt="BKNR Logo" src="/image/bknr-logo.png" border="0" /> + <img width="88" height="31" alt="BKNR Logo" src="../image/bknr-logo.png" border="0" /> </a> </div> </div>

1 0

[Bknr-cvs] r1804 - trunk/projects/bknr-website/templates
by bknr＠bknr.net 24 Jan '06

24 Jan '06

Author: hhubner Date: 2006-01-24 05:14:49 -0600 (Tue, 24 Jan 2006) New Revision: 1804 Removed: trunk/projects/bknr-website/templates/applications.bknr trunk/projects/bknr-website/templates/contact.bknr trunk/projects/bknr-website/templates/development-style.bknr trunk/projects/bknr-website/templates/documentation.bknr trunk/projects/bknr-website/templates/getting.bknr trunk/projects/bknr-website/templates/home.bknr trunk/projects/bknr-website/templates/license.bknr trunk/projects/bknr-website/templates/platforms.bknr trunk/projects/bknr-website/templates/technology.bknr trunk/projects/bknr-website/templates/toplevel.bknr trunk/projects/bknr-website/templates/user-error.bknr trunk/projects/bknr-website/templates/why-no-db.bknr Log: Delete these again, Subversion seems to have overlooked the previous commit. Deleted: trunk/projects/bknr-website/templates/applications.bknr =================================================================== --- trunk/projects/bknr-website/templates/applications.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/applications.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,22 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="Applications" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>Applications</h1> -<p>The following public web sites are based on BKNR (in order of going on-line): -<ul> - <li><a target="_new" href="http://eboy.com/">eboy</a></li> - <li><a target="_new" href="http://createrainforest.org/">Create Rainforest</a></li> - <li><a target="_new" href="http://quickhoney.com">Quickhoney</a></li> - <li><a target="_new" href="http://lisp-ecoop05.bknr.net">LISP ECOOP05 Workshop</a></li> -</ul> -<p>Of course, this web site uses BKNR, too!</p> -</p> -</bknr:toplevel> Deleted: trunk/projects/bknr-website/templates/contact.bknr =================================================================== --- trunk/projects/bknr-website/templates/contact.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/contact.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,22 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="Contact" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>Contact</h1> - -<p>If you intend to use BKNR or parts of it, we'd love to hear from -you!</p> - -<p>To get in touch, please send mail to the developer's mailing list -at bknr-devel at common-lisp dot net. You may also <a -href="http://common-lisp.net/cgi-bin/mailman/listinfo/bknr-devel">subscribe</a> -to the mailing list if you are interested in participating.</p> - -</bknr:toplevel> Deleted: trunk/projects/bknr-website/templates/development-style.bknr =================================================================== --- trunk/projects/bknr-website/templates/development-style.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/development-style.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,90 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="BKNR technology" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h2>BKNR programming style</h2> -<p> -All BKNR application data is handled in main memory. Internally, -applications do not use secondary store like data bases or files. Are -application data structures are kept in the data structures provided -by Common Lisp. -</p> -<p> -All destructive operation on the persistent heap need to be explicit -and are synchronized. A transaction is never aborted nor may it fail. -Thus, it is vital to check preconditions before starting a destructive -operation. Within a transaction, application code must properly -handle all possible errors and gracefully return. Errors unhandled in -transaction code are considered fatal and cause the persistence system -to stop. -</p> -<p> -Applications may either define their own, named transactions or they -may use the provided CLOS layer which groups accesses to slots of -persistent objects to atomic transactions. -</p> -<p> -BKNR persistence sequentializes all destructive operations on the -persistent heap. As all data is in RAM when a transaction starts -executing, it is never stalled by having to wait for necessary data to -arrive. Thus, the need for preempting transaction code arises much -less frequently than in traditional systems in which transactions had -to access slow disks in order to collect the data to be processed. -</p> -<p> -Some applications require precondition checks which must be processed -atomically together with the associated transaction code. -Applications must guard such precondition checks with a store lock in -order to block other transaction code from executing. -</p> -<p> -Transaction code must be used only to change the persistent state of a -system. No I/O operations must be performed within transaction code. -Transactions may produce log output, but it they may not use (possibly -blocking) communications mechanisms to other processes. -</p> -<h2>Areas of research</h2> -<h3>Performance</h3> -<p> -For high-performance stores, some optimizations will be worthwile. -The single most time consuming operation while executing transactions -is the appending to the transaction log file. At the moment, this is -done using a synchronous write to the opened Unix file, which takes -significant time. -</p> -<p> -Not all operations need to be absolutely safe, and it might be -worthwile to change the default execution mode of the store to be as -follows: Processing other transactions or non-transaction code may -continue as soon as the transaction log entry of the current operation -has been constructed in RAM and the transaction application code has -been executed. The transaction system will then asynchronously write -the transaction to the transaction log. Non-transactional application -code can continue executing while the log entry is being commited to -disk. Depending on the safety needs of the application, log entries -could also be buffered in a queue to achive higher peak transaction -rates, trading safety for speed. If safety is required, fast stable -store (e.g. battery-backed RAM) can increase the speed of synchronous -log writes. -</p> -<h2>Locking API</h2> -<p> -Current applications do not require sophisticated locking. To support -such applications, a locking API might make sense. -</p> -<h2>Replication</h2> -<p> -Hot-standby servers using the BKNR datastore are conceptually simple. -Full commit safety requires a slightly more involved commit -coordination on the distributed servers than doing the log replication -after the commit has locally finished. Many applications will be able -to loose one or even a few transactions should the system crash. -</p> -</bknr:toplevel> Deleted: trunk/projects/bknr-website/templates/documentation.bknr =================================================================== --- trunk/projects/bknr-website/templates/documentation.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/documentation.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,31 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="Documentation" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>Documentation</h1> - -<p>The following documentation in PDF format is available:</p> - -<ul> - - <li>The <a href="/pdf/datastore-manual" target="bknr_pdf">datastore - manual</a> describes the persistence mechanism including the - CLOS-based indexing facility</li> - - <li>The KlammerScript <a href="/pdf/js-manual" - target="bknr_pdf">manual</a> and <a href="/pdf/js-reference" - target="bknr_pdf">reference</a> describe the Lisp to Javascript - converter</li> - -</ul> - -<p>Kudos to Manuel for writing the documentation!</p> - -</bknr:toplevel> Deleted: trunk/projects/bknr-website/templates/getting.bknr =================================================================== --- trunk/projects/bknr-website/templates/getting.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/getting.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,55 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="Getting BKNR" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - - <h1>Getting BKNR</h1> - - <p>Currently, there is are no formal releases of the BKNR - environment. We are working with a <a - href="http://subversion.tigris.org" target="_new">Subversion</a> - repository which is publicy accessible.</p> - - <p>The BKNR repository contains the framework, all software packages - used by BKNR as well as well as several real-world applications which - have been deployed in the internet. The application sources are - provided as example material.</p> - - <h2>Using Subversion</h2> - - <p>To check out the current state of the repository, please install - the <a href="http://subversion.tigris.org" target="_new">Subversion</a> client on your machine and type</p> - - <blockquote> - <tt> - svn co svn://common-lisp.net/project/bknr/svn/trunk <b><i>bknr-svn</i></b> - </tt> - </blockquote> - - <p>This will store the source tree in the <tt><b><i>bknr-svn</i></b></tt> - directory of your local file system. You may specify a different path - if you wish.</p> - -  - -</bknr:toplevel> Deleted: trunk/projects/bknr-website/templates/home.bknr =================================================================== --- trunk/projects/bknr-website/templates/home.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/home.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,108 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="BKNR Home" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>Welcome to BKNR!</h1> - -<p>Welcome to the Website of BKNR, the Common Lisp Web Application -environment. This website aims to introduce the BKNR platform as well -as provide you with pointers to the software itself.</p> - -<h2>What is BKNR?</h2> -<p> - -BKNR is a set of Common Lisp libraries which together form an -environment suitable for serving HTTP clients from a persistent Lisp -system. - -It's major components are: -<ul> -<li>Persistence mechanism based on transaction logging, supporting -immutable binary large objects and CLOS persistence.</li> -<li>XML processing facilities</li> -<li>HTTP application environment with session handling and template engine</li> -</ul> -</p> - -<h3>Persistence</h3> -<p> -Persistence in BKNR is achived using a transaction logging mechanism. -All operations which change the persistent image of a system are -explicitely written to a transaction log file. When the system -crashes, the persistent state can be recovered by rolling forward the -transaction log. The transaction log is held in a simple binary -format in order to get acceptable restart times for larger datasets. -</p> -<p> -The persistence mechanism supports a snapshot API which allows the -persistent object system to write all currently active objects to a -sequential file. -</p> -<p> -The Persistent object subsystem provides for ID generation of objects. -Object IDs of persistent objects are written to the transaction log. -Persistent objects are never garbage collected and need to be deleted -by the application if they are no longer in use. -</p> -<p> -BKNR supports automated indices for CLOS instances. They are -implemented in a MOP metaclass and compatible with the BKNR metaclass -for persistent objects. -</p> -<h3>XML processing</h3> -<p> -BKNR integrates the Closure XML (CXML) parser using a CLOS metaclass -to provide for reading and writing XML files of objects. Combined -metaclasses are provided in order to allow for combinations like -indexed+persistent or indexed+xml. -</p> -<p> -CXML is also used for XHTML generation and XHTML template processing. -User-defined element handlers can be added to the XHTML generation to -support application-specific generation of dynamic content. -</p> -<h3>Web application environment</h3> -<p> -BKNR uses the portable aserve web server implementation as HTTP -server. It provides for a handler dispatch mechanism based on CLOS -objects and generic functions to provide for routing requests to -objects and HTML form handling. -</p> -<p> -Session handling through cookies is supported, as well is a simple -web-based CMS for maintaining user accounts and other application -information. -</p> -<p> -A CSS and Javascript generation library supports in-source-code -generation of complete web pages using a lisp-like syntax. -</p> -<h3>Other Libraries</h3> -<p> -Except for the graphics processing library used, all server-side -components of BKNR are implemented in Common Lisp. All components are -Open Source. All software outside of the thirdparty/ tree in the BKNR -repository are distributed under a BSD-style open source license. The -thirdparty/ tree contains a number of publicly available Common Lisp -libraries which are used by BKNR. -</p> -BKNR has been co-developed with a number of real-world applications. -Much of the application code has been kept in the central source code -repository and evolved through a number of API and framework changes. - - -BKNR started while implementing a -web site for <a href="http://eboy.com">eboy</a>, a group of graphics -artists who wanted to have a dynamic web site for publishing their -works. Their new, fully dynamic web site was implemented in CMU -Common Lisp - - -</bknr:toplevel> Deleted: trunk/projects/bknr-website/templates/license.bknr =================================================================== --- trunk/projects/bknr-website/templates/license.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/license.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,44 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="BKNR License" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - <p>Copyright (c) 2003,2004,2005, BKNR (Hans Hübner, Manuel Odendahl)<br /> - All rights reserved.</p> - - <p>Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions - are met:</p> - - <ul> - - <li>Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer.</li> - - <li>Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution.</li> - - <li>Neither the name BKNR nor the names of its contributors - may be used to endorse or promote products derived from this software - without specific prior written permission.</li> - - </ul> - - <p>THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR - CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, - EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, - PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR - PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF - LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING - NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS - SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p> -</bknr:toplevel> Deleted: trunk/projects/bknr-website/templates/platforms.bknr =================================================================== --- trunk/projects/bknr-website/templates/platforms.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/platforms.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,26 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="Platforms" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>BKNR platforms</h1> - -<p>BKNR is developed using the <a -href="http://www.cons.org/cmucl/">CMU Common Lisp</a> compiler on the -<a href="http://freebsd.org/">FreeBSD</a> operting system. It is -known to run on CMUCL on Linux, and the datastore components have been -tested on the <a href="http://franz.com/products/allegrocl/">Allegro -Common Lisp</a> compiler. Portability is not our main concern, but we -will accept portability patches if they do not affect the mainline -development too much.</p> - -<p>That said, most of the components are written in portable Common -Lisp, but some of the application modules depend on CMUCL extensions.</p> - -</bknr:toplevel> Deleted: trunk/projects/bknr-website/templates/technology.bknr =================================================================== Deleted: trunk/projects/bknr-website/templates/toplevel.bknr =================================================================== --- trunk/projects/bknr-website/templates/toplevel.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/toplevel.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,43 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr-website="http://bknr.net" - xmlns:bknr="http://bknr.net" - xmlns:menu="http://bknr.net/menu" - > - <head> - <title>BKNR - $(title)</title> - <link rel="stylesheet" type="text/css" href="/static/styles.css" /> - <script src="/static/javascript.js" language="javascript" type="text/javascript"> </script> - </head> - - <body> - <div id="banner"> - <div id="title">BKNR Lisp Application Environment</div> - <div id="logo"> - <a href="http://common-lisp.net/project/bknr/home.html" target="_new"> - <img width="88" height="31" alt="BKNR Logo" src="/image/bknr-logo" border="0" /> - </a> - </div> - </div> - <div id="body"> - <div id="system-column"> - <menu:site-menu config="menu.xml" - menu-name="main" - container-class="site-menu" - active-class="site-menu-active" - inactive-class="site-menu-inactive" /> - - </div> - <div id="content"> - <bknr:tag-body /> - </div> - </div> - </body> -</html> Deleted: trunk/projects/bknr-website/templates/user-error.bknr =================================================================== --- trunk/projects/bknr-website/templates/user-error.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/user-error.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,14 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - xmlns:menu="http://bknr.net/menu" - > -Your request could not be processed because an error occured: -<pre> -$(error-message) -</pre> -</html> \ No newline at end of file Deleted: trunk/projects/bknr-website/templates/why-no-db.bknr =================================================================== --- trunk/projects/bknr-website/templates/why-no-db.bknr 2006-01-24 11:10:26 UTC (rev 1803) +++ trunk/projects/bknr-website/templates/why-no-db.bknr 2006-01-24 11:14:49 UTC (rev 1804) @@ -1,79 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="BKNR technology" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>Requirements for a persistence mechanism</h1> -<p> -We want a persistence mechanism which is closely integrated into our -programming language. Persistence is something we want to assume as -being available which writing applications, and it should be as -unintrusive as possible. Applications should use standard programming -language mechanisms to access all data. -</p> -<p> -The persistence mechanism should ensure that all appplication data in -the system is safe against system crashes. If the system crashes, the -application and all it's data should be restartable into a consistent -state. The amount of work which can be lost due to a unplanned system -failure should be low. -</p> -<p> -The persistence mechanism should make the amount of data which -constitutes the persistent state of the application transparent. It -should provide for mechanisms to duplicate the current state in order -to move it from one machine or software release to another. -</p> -<h1>Does a "Database system" help?</h1> -<p> -The two most popular database families today are relational databases -with SQL as query language, and embedded database facilities like -Berkeley DB which provides for indexed access to tables stored on -disk. They have in common that they assume that the primary location -of data is on-disk and that applications have to read and write data -from and to disk in order to perform their tasks. -</p> -<p> -Database systems, when they were invented, served as an address -extension to the applications. Applications could operate on data -sets which were to large for in-memory processing, providing -persistence at the same time. -</p> -<p> -In addition, SQL databases provide for a language neutral query -language that allow flexible querying of the application data. This -facility is useful in multi-language environments and to facilitate -database queries through third-party applications. -</p> -<p> -Todays main memories and processing speed redefine the environment in -which applications are created. Memory is no longer a very scarce -resource, and memory sizes have generally grown much faster than the -amount of application data that needs to be processed. Thus, -on-demand loading of application from disk can (and should) be totally -avoided by always having the complete data set in memory. -</p> -<h2>Properties of the BKNR persistence mechanism</h2> -<p> -All Disk access by the persistence mechanism is sequential. During -normal operation, the transaction log is sequentially appended to. -During snapshot, the snapshot file of the object subsystem is -sequentially written. During restore, the snapshot and transaction -log files are sequentially read. -</p> -<p> -All files used by BKNR are immutable. A file is never changed, but -only created, read or deleted. -</p> -<p> -The time needed to restore from a crash consists of the time needed to -read the sequential log file, to parse it's content and to execute the -applications' transaction code. -</p> -</bknr:toplevel>

1 0

[Bknr-cvs] r1803 - in trunk/projects/bknr-website: . src templates website
by bknr＠bknr.net 24 Jan '06

24 Jan '06

Author: hhubner Date: 2006-01-24 05:10:26 -0600 (Tue, 24 Jan 2006) New Revision: 1803 Added: trunk/projects/bknr-website/image/ trunk/projects/bknr-website/static/ trunk/projects/bknr-website/templates/ trunk/projects/bknr-website/templates/applications.xml trunk/projects/bknr-website/templates/bknr.xsl trunk/projects/bknr-website/templates/contact.xml trunk/projects/bknr-website/templates/development-style.xml trunk/projects/bknr-website/templates/documentation.xml trunk/projects/bknr-website/templates/getting.xml trunk/projects/bknr-website/templates/home.xml trunk/projects/bknr-website/templates/license.xml trunk/projects/bknr-website/templates/menu.xml trunk/projects/bknr-website/templates/platforms.xml trunk/projects/bknr-website/templates/user-error.xml trunk/projects/bknr-website/templates/why-no-db.xml Removed: trunk/projects/bknr-website/src/bknr-logo.png trunk/projects/bknr-website/templates/menu.xml trunk/projects/bknr-website/website/image/ trunk/projects/bknr-website/website/static/ trunk/projects/bknr-website/website/templates/ Log: Reorganize directory structure, the website is now XSL based and does not have a BKNR runtime component. Copied: trunk/projects/bknr-website/image (from rev 1802, trunk/projects/bknr-website/website/image) Deleted: trunk/projects/bknr-website/src/bknr-logo.png =================================================================== (Binary files differ) Copied: trunk/projects/bknr-website/static (from rev 1800, trunk/projects/bknr-website/website/static) Copied: trunk/projects/bknr-website/templates (from rev 1800, trunk/projects/bknr-website/website/templates) Copied: trunk/projects/bknr-website/templates/applications.xml (from rev 1802, trunk/projects/bknr-website/website/templates/applications.xml) Copied: trunk/projects/bknr-website/templates/bknr.xsl (from rev 1802, trunk/projects/bknr-website/website/templates/bknr.xsl) Copied: trunk/projects/bknr-website/templates/contact.xml (from rev 1802, trunk/projects/bknr-website/website/templates/contact.xml) Copied: trunk/projects/bknr-website/templates/development-style.xml (from rev 1802, trunk/projects/bknr-website/website/templates/development-style.xml) Copied: trunk/projects/bknr-website/templates/documentation.xml (from rev 1802, trunk/projects/bknr-website/website/templates/documentation.xml) Copied: trunk/projects/bknr-website/templates/getting.xml (from rev 1802, trunk/projects/bknr-website/website/templates/getting.xml) Copied: trunk/projects/bknr-website/templates/home.xml (from rev 1802, trunk/projects/bknr-website/website/templates/home.xml) Copied: trunk/projects/bknr-website/templates/license.xml (from rev 1802, trunk/projects/bknr-website/website/templates/license.xml) Deleted: trunk/projects/bknr-website/templates/menu.xml =================================================================== --- trunk/projects/bknr-website/website/templates/menu.xml 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/templates/menu.xml 2006-01-24 11:10:26 UTC (rev 1803) @@ -1,12 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<menus> - <menu name="main"> - <item url="/home" title="Home" /> - <item url="/applications" title="Applications" /> - <item url="/platforms" title="Platforms" /> - <item url="/documentation" title="Documentation" /> - <item url="/license" title="License" /> - <item url="/getting" title="Getting BKNR" /> - <item url="/contact" title="Contact" /> - </menu> -</menus> \ No newline at end of file Copied: trunk/projects/bknr-website/templates/menu.xml (from rev 1802, trunk/projects/bknr-website/website/templates/menu.xml) Copied: trunk/projects/bknr-website/templates/platforms.xml (from rev 1802, trunk/projects/bknr-website/website/templates/platforms.xml) Copied: trunk/projects/bknr-website/templates/user-error.xml (from rev 1802, trunk/projects/bknr-website/website/templates/user-error.xml) Copied: trunk/projects/bknr-website/templates/why-no-db.xml (from rev 1802, trunk/projects/bknr-website/website/templates/why-no-db.xml)

1 0

[Bknr-cvs] r1802 - in trunk/projects/bknr-website/website: . image
by bknr＠bknr.net 24 Jan '06

24 Jan '06

Author: hhubner Date: 2006-01-24 05:05:26 -0600 (Tue, 24 Jan 2006) New Revision: 1802 Added: trunk/projects/bknr-website/website/image/ trunk/projects/bknr-website/website/image/bknr-logo.png Log: Add BKNR logo as static file Copied: trunk/projects/bknr-website/website/image/bknr-logo.png (from rev 1800, trunk/projects/bknr-website/src/bknr-logo.png)

1 0

[Bknr-cvs] r1801 - trunk/projects/bknr-website/website/templates
by bknr＠bknr.net 24 Jan '06

24 Jan '06

Author: hhubner Date: 2006-01-24 05:04:26 -0600 (Tue, 24 Jan 2006) New Revision: 1801 Added: trunk/projects/bknr-website/website/templates/applications.xml trunk/projects/bknr-website/website/templates/bknr.xsl trunk/projects/bknr-website/website/templates/contact.xml trunk/projects/bknr-website/website/templates/development-style.xml trunk/projects/bknr-website/website/templates/documentation.xml trunk/projects/bknr-website/website/templates/getting.xml trunk/projects/bknr-website/website/templates/home.xml trunk/projects/bknr-website/website/templates/license.xml trunk/projects/bknr-website/website/templates/platforms.xml trunk/projects/bknr-website/website/templates/user-error.xml trunk/projects/bknr-website/website/templates/why-no-db.xml Removed: trunk/projects/bknr-website/website/templates/applications.bknr trunk/projects/bknr-website/website/templates/contact.bknr trunk/projects/bknr-website/website/templates/development-style.bknr trunk/projects/bknr-website/website/templates/documentation.bknr trunk/projects/bknr-website/website/templates/getting.bknr trunk/projects/bknr-website/website/templates/home.bknr trunk/projects/bknr-website/website/templates/license.bknr trunk/projects/bknr-website/website/templates/platforms.bknr trunk/projects/bknr-website/website/templates/technology.bknr trunk/projects/bknr-website/website/templates/toplevel.bknr trunk/projects/bknr-website/website/templates/user-error.bknr trunk/projects/bknr-website/website/templates/why-no-db.bknr Modified: trunk/projects/bknr-website/website/templates/menu.xml Log: Switch to XSLT based documentation. Deleted: trunk/projects/bknr-website/website/templates/applications.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/applications.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/applications.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,22 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="Applications" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>Applications</h1> -<p>The following public web sites are based on BKNR (in order of going on-line): -<ul> - <li><a target="_new" href="http://eboy.com/">eboy</a></li> - <li><a target="_new" href="http://createrainforest.org/">Create Rainforest</a></li> - <li><a target="_new" href="http://quickhoney.com">Quickhoney</a></li> - <li><a target="_new" href="http://lisp-ecoop05.bknr.net">LISP ECOOP05 Workshop</a></li> -</ul> -<p>Of course, this web site uses BKNR, too!</p> -</p> -</bknr:toplevel> Copied: trunk/projects/bknr-website/website/templates/applications.xml (from rev 1800, trunk/projects/bknr-website/website/templates/applications.bknr) =================================================================== --- trunk/projects/bknr-website/website/templates/applications.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/applications.xml 2006-01-24 11:04:26 UTC (rev 1801) @@ -0,0 +1,13 @@ +<?xml version="1.0" encoding="UTF-8"?> +<?xml-stylesheet type="text/xsl" href="bknr.xsl" ?> +<page name="applications"> + <h1>Applications</h1> + <p>The following public web sites are based on BKNR (in order of going on-line): + <ul> + <li><a target="_new" href="http://eboy.com/">eboy</a></li> + <li><a target="_new" href="http://createrainforest.org/">Create Rainforest</a></li> + <li><a target="_new" href="http://quickhoney.com">Quickhoney</a></li> + <li><a target="_new" href="http://lisp-ecoop05.bknr.net">LISP ECOOP05 Workshop (now in archive mode)</a></li> + </ul> + </p> +</page> \ No newline at end of file Added: trunk/projects/bknr-website/website/templates/bknr.xsl =================================================================== --- trunk/projects/bknr-website/website/templates/bknr.xsl 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/bknr.xsl 2006-01-24 11:04:26 UTC (rev 1801) @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="iso-8859-1" ?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> + + <xsl:param name="mode">xml</xsl:param> + + <xsl:output method="html" + indent="yes" + omit-xml-declaration="yes" + doctype-public="-//W3C//DTD HTML 4.0 Strict//EN" /> + + <xsl:template match="/page"> + + <html + xmlns="http://www.w3.org/1999/xhtml"> + <head> + <title>BKNR - <xsl:value-of select="@name"/></title> + <link rel="stylesheet" type="text/css" href="../static/styles.css" /> + <script src="../static/javascript.js" language="javascript" type="text/javascript"> </script> + </head> + + <body> + <div id="banner"> + <div id="title">BKNR Lisp Application Environment</div> + <div id="logo"> + <a href="http://bknr.net/" target="_new"> + <img width="88" height="31" alt="BKNR Logo" src="/image/bknr-logo.png" border="0" /> + </a> + </div> + </div> + <div id="body"> + <div id="system-column"> + <xsl:call-template name="menu"> + <xsl:with-param name="current" select="@name"/> + </xsl:call-template> + </div> + <div id="content"> + <xsl:copy-of select="." /> + </div> + </div> + </body> + </html> + </xsl:template> + + <xsl:template name="menu"> + <xsl:param name="current"/> + <div class="site-menu"> + <xsl:for-each select="document('menu.xml')/menu/item"> + <xsl:choose> + <xsl:when test="@url = $current"> + <div class="site-menu-active"> + <xsl:value-of select="@title"/> + </div> + </xsl:when> + <xsl:otherwise> + <div class="site-menu-inactive"> + <a href="{(a)url}.{$mode}"><xsl:value-of select="@title"/></a> + </div> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> + </div> + </xsl:template> + +</xsl:stylesheet> \ No newline at end of file Deleted: trunk/projects/bknr-website/website/templates/contact.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/contact.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/contact.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,22 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="Contact" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>Contact</h1> - -<p>If you intend to use BKNR or parts of it, we'd love to hear from -you!</p> - -<p>To get in touch, please send mail to the developer's mailing list -at bknr-devel at common-lisp dot net. You may also <a -href="http://common-lisp.net/cgi-bin/mailman/listinfo/bknr-devel">subscribe</a> -to the mailing list if you are interested in participating.</p> - -</bknr:toplevel> Copied: trunk/projects/bknr-website/website/templates/contact.xml (from rev 1800, trunk/projects/bknr-website/website/templates/contact.bknr) =================================================================== --- trunk/projects/bknr-website/website/templates/contact.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/contact.xml 2006-01-24 11:04:26 UTC (rev 1801) @@ -0,0 +1,13 @@ +<?xml version="1.0" encoding="UTF-8"?> +<?xml-stylesheet type="text/xsl" href="bknr.xsl" ?> +<page name="contact"> + <h1>Contact</h1> + + <p>If you intend to use BKNR or parts of it, we'd love to hear from + you!</p> + + <p>To get in touch, please send mail to the developer's mailing list + at bknr-devel at common-lisp dot net. You may also <a + href="http://common-lisp.net/cgi-bin/mailman/listinfo/bknr-devel">subscribe</a> + to the mailing list if you are interested in participating.</p> +</page> \ No newline at end of file Deleted: trunk/projects/bknr-website/website/templates/development-style.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/development-style.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/development-style.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,90 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="BKNR technology" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h2>BKNR programming style</h2> -<p> -All BKNR application data is handled in main memory. Internally, -applications do not use secondary store like data bases or files. Are -application data structures are kept in the data structures provided -by Common Lisp. -</p> -<p> -All destructive operation on the persistent heap need to be explicit -and are synchronized. A transaction is never aborted nor may it fail. -Thus, it is vital to check preconditions before starting a destructive -operation. Within a transaction, application code must properly -handle all possible errors and gracefully return. Errors unhandled in -transaction code are considered fatal and cause the persistence system -to stop. -</p> -<p> -Applications may either define their own, named transactions or they -may use the provided CLOS layer which groups accesses to slots of -persistent objects to atomic transactions. -</p> -<p> -BKNR persistence sequentializes all destructive operations on the -persistent heap. As all data is in RAM when a transaction starts -executing, it is never stalled by having to wait for necessary data to -arrive. Thus, the need for preempting transaction code arises much -less frequently than in traditional systems in which transactions had -to access slow disks in order to collect the data to be processed. -</p> -<p> -Some applications require precondition checks which must be processed -atomically together with the associated transaction code. -Applications must guard such precondition checks with a store lock in -order to block other transaction code from executing. -</p> -<p> -Transaction code must be used only to change the persistent state of a -system. No I/O operations must be performed within transaction code. -Transactions may produce log output, but it they may not use (possibly -blocking) communications mechanisms to other processes. -</p> -<h2>Areas of research</h2> -<h3>Performance</h3> -<p> -For high-performance stores, some optimizations will be worthwile. -The single most time consuming operation while executing transactions -is the appending to the transaction log file. At the moment, this is -done using a synchronous write to the opened Unix file, which takes -significant time. -</p> -<p> -Not all operations need to be absolutely safe, and it might be -worthwile to change the default execution mode of the store to be as -follows: Processing other transactions or non-transaction code may -continue as soon as the transaction log entry of the current operation -has been constructed in RAM and the transaction application code has -been executed. The transaction system will then asynchronously write -the transaction to the transaction log. Non-transactional application -code can continue executing while the log entry is being commited to -disk. Depending on the safety needs of the application, log entries -could also be buffered in a queue to achive higher peak transaction -rates, trading safety for speed. If safety is required, fast stable -store (e.g. battery-backed RAM) can increase the speed of synchronous -log writes. -</p> -<h2>Locking API</h2> -<p> -Current applications do not require sophisticated locking. To support -such applications, a locking API might make sense. -</p> -<h2>Replication</h2> -<p> -Hot-standby servers using the BKNR datastore are conceptually simple. -Full commit safety requires a slightly more involved commit -coordination on the distributed servers than doing the log replication -after the commit has locally finished. Many applications will be able -to loose one or even a few transactions should the system crash. -</p> -</bknr:toplevel> Copied: trunk/projects/bknr-website/website/templates/development-style.xml (from rev 1800, trunk/projects/bknr-website/website/templates/development-style.bknr) =================================================================== --- trunk/projects/bknr-website/website/templates/development-style.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/development-style.xml 2006-01-24 11:04:26 UTC (rev 1801) @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="UTF-8"?> +<?xml-stylesheet type="text/xsl" href="bknr.xsl" ?> +<page name="development-style"> + <h2>BKNR programming style</h2> + <p> + All BKNR application data is handled in main memory. Internally, + applications do not use secondary store like data bases or files. Are + application data structures are kept in the data structures provided + by Common Lisp. + </p> + <p> + All destructive operation on the persistent heap need to be explicit + and are synchronized. A transaction is never aborted nor may it fail. + Thus, it is vital to check preconditions before starting a destructive + operation. Within a transaction, application code must properly + handle all possible errors and gracefully return. Errors unhandled in + transaction code are considered fatal and cause the persistence system + to stop. + </p> + <p> + Applications may either define their own, named transactions or they + may use the provided CLOS layer which groups accesses to slots of + persistent objects to atomic transactions. + </p> + <p> + BKNR persistence sequentializes all destructive operations on the + persistent heap. As all data is in RAM when a transaction starts + executing, it is never stalled by having to wait for necessary data to + arrive. Thus, the need for preempting transaction code arises much + less frequently than in traditional systems in which transactions had + to access slow disks in order to collect the data to be processed. + </p> + <p> + Some applications require precondition checks which must be processed + atomically together with the associated transaction code. + Applications must guard such precondition checks with a store lock in + order to block other transaction code from executing. + </p> + <p> + Transaction code must be used only to change the persistent state of a + system. No I/O operations must be performed within transaction code. + Transactions may produce log output, but it they may not use (possibly + blocking) communications mechanisms to other processes. + </p> + <h2>Areas of research</h2> + <h3>Performance</h3> + <p> + For high-performance stores, some optimizations will be worthwile. + The single most time consuming operation while executing transactions + is the appending to the transaction log file. At the moment, this is + done using a synchronous write to the opened Unix file, which takes + significant time. + </p> + <p> + Not all operations need to be absolutely safe, and it might be + worthwile to change the default execution mode of the store to be as + follows: Processing other transactions or non-transaction code may + continue as soon as the transaction log entry of the current operation + has been constructed in RAM and the transaction application code has + been executed. The transaction system will then asynchronously write + the transaction to the transaction log. Non-transactional application + code can continue executing while the log entry is being commited to + disk. Depending on the safety needs of the application, log entries + could also be buffered in a queue to achive higher peak transaction + rates, trading safety for speed. If safety is required, fast stable + store (e.g. battery-backed RAM) can increase the speed of synchronous + log writes. + </p> + <h2>Locking API</h2> + <p> + Current applications do not require sophisticated locking. To support + such applications, a locking API might make sense. + </p> + <h2>Replication</h2> + <p> + Hot-standby servers using the BKNR datastore are conceptually simple. + Full commit safety requires a slightly more involved commit + coordination on the distributed servers than doing the log replication + after the commit has locally finished. Many applications will be able + to loose one or even a few transactions should the system crash. + </p> +</page> \ No newline at end of file Deleted: trunk/projects/bknr-website/website/templates/documentation.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/documentation.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/documentation.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,31 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="Documentation" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>Documentation</h1> - -<p>The following documentation in PDF format is available:</p> - -<ul> - - <li>The <a href="/pdf/datastore-manual" target="bknr_pdf">datastore - manual</a> describes the persistence mechanism including the - CLOS-based indexing facility</li> - - <li>The KlammerScript <a href="/pdf/js-manual" - target="bknr_pdf">manual</a> and <a href="/pdf/js-reference" - target="bknr_pdf">reference</a> describe the Lisp to Javascript - converter</li> - -</ul> - -<p>Kudos to Manuel for writing the documentation!</p> - -</bknr:toplevel> Copied: trunk/projects/bknr-website/website/templates/documentation.xml (from rev 1800, trunk/projects/bknr-website/website/templates/documentation.bknr) =================================================================== --- trunk/projects/bknr-website/website/templates/documentation.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/documentation.xml 2006-01-24 11:04:26 UTC (rev 1801) @@ -0,0 +1,22 @@ +<?xml version="1.0" encoding="UTF-8"?> +<?xml-stylesheet type="text/xsl" href="bknr.xsl" ?> +<page name="documentation"> + <h1>Documentation</h1> + + <p>The following documentation in PDF format is available:</p> + + <ul> + + <li>The <a href="/pdf/datastore-manual" target="bknr_pdf">datastore + manual</a> describes the persistence mechanism including the + CLOS-based indexing facility</li> + + <li>The KlammerScript <a href="/pdf/js-manual" + target="bknr_pdf">manual</a> and <a href="/pdf/js-reference" + target="bknr_pdf">reference</a> describe the Lisp to Javascript + converter</li> + + </ul> + + <p>Kudos to Manuel for writing the documentation!</p> +</page> \ No newline at end of file Deleted: trunk/projects/bknr-website/website/templates/getting.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/getting.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/getting.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,55 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="Getting BKNR" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - - <h1>Getting BKNR</h1> - - <p>Currently, there is are no formal releases of the BKNR - environment. We are working with a <a - href="http://subversion.tigris.org" target="_new">Subversion</a> - repository which is publicy accessible.</p> - - <p>The BKNR repository contains the framework, all software packages - used by BKNR as well as well as several real-world applications which - have been deployed in the internet. The application sources are - provided as example material.</p> - - <h2>Using Subversion</h2> - - <p>To check out the current state of the repository, please install - the <a href="http://subversion.tigris.org" target="_new">Subversion</a> client on your machine and type</p> - - <blockquote> - <tt> - svn co svn://common-lisp.net/project/bknr/svn/trunk <b><i>bknr-svn</i></b> - </tt> - </blockquote> - - <p>This will store the source tree in the <tt><b><i>bknr-svn</i></b></tt> - directory of your local file system. You may specify a different path - if you wish.</p> - -  - -</bknr:toplevel> Copied: trunk/projects/bknr-website/website/templates/getting.xml (from rev 1800, trunk/projects/bknr-website/website/templates/getting.bknr) =================================================================== --- trunk/projects/bknr-website/website/templates/getting.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/getting.xml 2006-01-24 11:04:26 UTC (rev 1801) @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> +<?xml-stylesheet type="text/xsl" href="bknr.xsl" ?> +<page name="getting"> + <h1>Getting BKNR</h1> + + <p>Currently, there is are no formal releases of the BKNR + environment. We are working with a <a + href="http://subversion.tigris.org" target="_new">Subversion</a> + repository which is publicy accessible. A big thanks to the folks at + <a href="http://common-lisp.net/" target="_new">common-lisp.net</a> + for hosting our project!</p> + + <p>The BKNR repository contains the framework, all software packages + used by BKNR as well as well as several real-world applications which + have been deployed in the internet. The application sources are + provided as example material.</p> + + <h2>Using Subversion</h2> + + <p>To check out the current state of the repository, please install + the <a href="http://subversion.tigris.org" + target="_new">Subversion</a> client on your machine and type</p> + + <blockquote> + <tt> + svn co svn://common-lisp.net/project/bknr/svn/trunk <b><i>bknr-svn</i></b> + </tt> + </blockquote> + + <p>This will store the source tree in the <tt><b><i>bknr-svn</i></b></tt> + directory of your local file system. You may specify a different path + if you wish.</p> + +  +</page> \ No newline at end of file Deleted: trunk/projects/bknr-website/website/templates/home.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/home.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/home.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,108 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="BKNR Home" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>Welcome to BKNR!</h1> - -<p>Welcome to the Website of BKNR, the Common Lisp Web Application -environment. This website aims to introduce the BKNR platform as well -as provide you with pointers to the software itself.</p> - -<h2>What is BKNR?</h2> -<p> - -BKNR is a set of Common Lisp libraries which together form an -environment suitable for serving HTTP clients from a persistent Lisp -system. - -It's major components are: -<ul> -<li>Persistence mechanism based on transaction logging, supporting -immutable binary large objects and CLOS persistence.</li> -<li>XML processing facilities</li> -<li>HTTP application environment with session handling and template engine</li> -</ul> -</p> - -<h3>Persistence</h3> -<p> -Persistence in BKNR is achived using a transaction logging mechanism. -All operations which change the persistent image of a system are -explicitely written to a transaction log file. When the system -crashes, the persistent state can be recovered by rolling forward the -transaction log. The transaction log is held in a simple binary -format in order to get acceptable restart times for larger datasets. -</p> -<p> -The persistence mechanism supports a snapshot API which allows the -persistent object system to write all currently active objects to a -sequential file. -</p> -<p> -The Persistent object subsystem provides for ID generation of objects. -Object IDs of persistent objects are written to the transaction log. -Persistent objects are never garbage collected and need to be deleted -by the application if they are no longer in use. -</p> -<p> -BKNR supports automated indices for CLOS instances. They are -implemented in a MOP metaclass and compatible with the BKNR metaclass -for persistent objects. -</p> -<h3>XML processing</h3> -<p> -BKNR integrates the Closure XML (CXML) parser using a CLOS metaclass -to provide for reading and writing XML files of objects. Combined -metaclasses are provided in order to allow for combinations like -indexed+persistent or indexed+xml. -</p> -<p> -CXML is also used for XHTML generation and XHTML template processing. -User-defined element handlers can be added to the XHTML generation to -support application-specific generation of dynamic content. -</p> -<h3>Web application environment</h3> -<p> -BKNR uses the portable aserve web server implementation as HTTP -server. It provides for a handler dispatch mechanism based on CLOS -objects and generic functions to provide for routing requests to -objects and HTML form handling. -</p> -<p> -Session handling through cookies is supported, as well is a simple -web-based CMS for maintaining user accounts and other application -information. -</p> -<p> -A CSS and Javascript generation library supports in-source-code -generation of complete web pages using a lisp-like syntax. -</p> -<h3>Other Libraries</h3> -<p> -Except for the graphics processing library used, all server-side -components of BKNR are implemented in Common Lisp. All components are -Open Source. All software outside of the thirdparty/ tree in the BKNR -repository are distributed under a BSD-style open source license. The -thirdparty/ tree contains a number of publicly available Common Lisp -libraries which are used by BKNR. -</p> -BKNR has been co-developed with a number of real-world applications. -Much of the application code has been kept in the central source code -repository and evolved through a number of API and framework changes. - - -BKNR started while implementing a -web site for <a href="http://eboy.com">eboy</a>, a group of graphics -artists who wanted to have a dynamic web site for publishing their -works. Their new, fully dynamic web site was implemented in CMU -Common Lisp - - -</bknr:toplevel> Added: trunk/projects/bknr-website/website/templates/home.xml =================================================================== --- trunk/projects/bknr-website/website/templates/home.xml 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/home.xml 2006-01-24 11:04:26 UTC (rev 1801) @@ -0,0 +1,98 @@ +<?xml version="1.0" encoding="UTF-8"?> +<?xml-stylesheet type="text/xsl" href="bknr.xsl" ?> +<page name="home"> + <h1>Welcome to BKNR!</h1> + + <p>Welcome to the Website of BKNR, the Common Lisp Web Application + environment. This website aims to introduce the BKNR platform as well + as provide you with pointers to the software itself.</p> + + <h2>What is BKNR?</h2> + <p> + + BKNR is a set of Common Lisp libraries which together form an + environment suitable for serving HTTP clients from a persistent Lisp + system. + + It's major components are: + <ul> + <li>Persistence mechanism based on transaction logging, supporting + immutable binary large objects and CLOS persistence.</li> + <li>XML processing facilities</li> + <li>HTTP application environment with session handling and template engine</li> + </ul> + </p> + + <h3>Persistence</h3> + <p> + Persistence in BKNR is achived using a transaction logging mechanism. + All operations which change the persistent image of a system are + explicitely written to a transaction log file. When the system + crashes, the persistent state can be recovered by rolling forward the + transaction log. The transaction log is held in a simple binary + format in order to get acceptable restart times for larger datasets. + </p> + <p> + The persistence mechanism supports a snapshot API which allows the + persistent object system to write all currently active objects to a + sequential file. + </p> + <p> + The Persistent object subsystem provides for ID generation of objects. + Object IDs of persistent objects are written to the transaction log. + Persistent objects are never garbage collected and need to be deleted + by the application if they are no longer in use. + </p> + <p> + BKNR supports automated indices for CLOS instances. They are + implemented in a MOP metaclass and compatible with the BKNR metaclass + for persistent objects. + </p> + <h3>XML processing</h3> + <p> + BKNR integrates the Closure XML (CXML) parser using a CLOS metaclass + to provide for reading and writing XML files of objects. Combined + metaclasses are provided in order to allow for combinations like + indexed+persistent or indexed+xml. + </p> + <p> + CXML is also used for XHTML generation and XHTML template processing. + User-defined element handlers can be added to the XHTML generation to + support application-specific generation of dynamic content. + </p> + <h3>Web application environment</h3> + <p> + BKNR uses the portable aserve web server implementation as HTTP + server. It provides for a handler dispatch mechanism based on CLOS + objects and generic functions to provide for routing requests to + objects and HTML form handling. + </p> + <p> + Session handling through cookies is supported, as well is a simple + web-based CMS for maintaining user accounts and other application + information. + </p> + <p> + A CSS and Javascript generation library supports in-source-code + generation of complete web pages using a lisp-like syntax. + </p> + <h3>Other Libraries</h3> + <p> + Except for the graphics processing library used, all server-side + components of BKNR are implemented in Common Lisp. All components are + Open Source. All software outside of the thirdparty/ tree in the BKNR + repository are distributed under a BSD-style open source license. The + thirdparty/ tree contains a number of publicly available Common Lisp + libraries which are used by BKNR. + </p> + BKNR has been co-developed with a number of real-world applications. + Much of the application code has been kept in the central source code + repository and evolved through a number of API and framework changes. + + + BKNR started while implementing a + web site for <a href="http://eboy.com">eboy</a>, a group of graphics + artists who wanted to have a dynamic web site for publishing their + works. Their new, fully dynamic web site was implemented in CMU + Common Lisp +</page> \ No newline at end of file Deleted: trunk/projects/bknr-website/website/templates/license.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/license.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/license.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,44 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="BKNR License" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - <p>Copyright (c) 2003,2004,2005, BKNR (Hans Hübner, Manuel Odendahl)<br /> - All rights reserved.</p> - - <p>Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions - are met:</p> - - <ul> - - <li>Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer.</li> - - <li>Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution.</li> - - <li>Neither the name BKNR nor the names of its contributors - may be used to endorse or promote products derived from this software - without specific prior written permission.</li> - - </ul> - - <p>THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR - CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, - EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, - PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR - PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF - LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING - NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS - SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p> -</bknr:toplevel> Copied: trunk/projects/bknr-website/website/templates/license.xml (from rev 1800, trunk/projects/bknr-website/website/templates/license.bknr) =================================================================== --- trunk/projects/bknr-website/website/templates/license.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/license.xml 2006-01-24 11:04:26 UTC (rev 1801) @@ -0,0 +1,37 @@ +<?xml version="1.0" encoding="UTF-8"?> +<?xml-stylesheet type="text/xsl" href="bknr.xsl" ?> +<page name="license"> + <p>Copyright (c) 2003,2004,2005, BKNR (Hans Hübner, Manuel Odendahl)<br /> + All rights reserved.</p> + + <p>Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met:</p> + + <ul> + + <li>Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer.</li> + + <li>Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution.</li> + + <li>Neither the name BKNR nor the names of its contributors + may be used to endorse or promote products derived from this software + without specific prior written permission.</li> + + </ul> + + <p>THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p> +</page> \ No newline at end of file Modified: trunk/projects/bknr-website/website/templates/menu.xml =================================================================== --- trunk/projects/bknr-website/website/templates/menu.xml 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/menu.xml 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,12 +1,10 @@ <?xml version="1.0" encoding="UTF-8"?> -<menus> - <menu name="main"> - <item url="/home" title="Home" /> - <item url="/applications" title="Applications" /> - <item url="/platforms" title="Platforms" /> - <item url="/documentation" title="Documentation" /> - <item url="/license" title="License" /> - <item url="/getting" title="Getting BKNR" /> - <item url="/contact" title="Contact" /> - </menu> -</menus> \ No newline at end of file +<menu name="main"> + <item url="home" title="Home" /> + <item url="applications" title="Applications" /> + <item url="platforms" title="Platforms" /> + <item url="documentation" title="Documentation" /> + <item url="license" title="License" /> + <item url="getting" title="Getting BKNR" /> + <item url="contact" title="Contact" /> +</menu> Deleted: trunk/projects/bknr-website/website/templates/platforms.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/platforms.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/platforms.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,26 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="Platforms" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>BKNR platforms</h1> - -<p>BKNR is developed using the <a -href="http://www.cons.org/cmucl/">CMU Common Lisp</a> compiler on the -<a href="http://freebsd.org/">FreeBSD</a> operting system. It is -known to run on CMUCL on Linux, and the datastore components have been -tested on the <a href="http://franz.com/products/allegrocl/">Allegro -Common Lisp</a> compiler. Portability is not our main concern, but we -will accept portability patches if they do not affect the mainline -development too much.</p> - -<p>That said, most of the components are written in portable Common -Lisp, but some of the application modules depend on CMUCL extensions.</p> - -</bknr:toplevel> Copied: trunk/projects/bknr-website/website/templates/platforms.xml (from rev 1800, trunk/projects/bknr-website/website/templates/platforms.bknr) =================================================================== --- trunk/projects/bknr-website/website/templates/platforms.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/platforms.xml 2006-01-24 11:04:26 UTC (rev 1801) @@ -0,0 +1,18 @@ +<?xml version="1.0" encoding="UTF-8"?> +<?xml-stylesheet type="text/xsl" href="bknr.xsl" ?> +<page name="platforms"> + <h1>BKNR platforms</h1> + + <p>BKNR is developed using the <a + href="http://www.cons.org/cmucl/">CMU Common Lisp</a> compiler on the + <a href="http://freebsd.org/">FreeBSD</a> operting system. It is + known to run on CMUCL on Linux, and the datastore components have been + tested on the <a href="http://franz.com/products/allegrocl/">Allegro + Common Lisp</a> compiler. Portability is not our main concern, but we + will accept portability patches if they do not affect the mainline + development too much.</p> + + <p>That said, most of the components are written in portable Common + Lisp, but some of the application modules depend on CMUCL extensions.</p> + +</page> Deleted: trunk/projects/bknr-website/website/templates/technology.bknr =================================================================== Deleted: trunk/projects/bknr-website/website/templates/toplevel.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/toplevel.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/toplevel.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,43 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr-website="http://bknr.net" - xmlns:bknr="http://bknr.net" - xmlns:menu="http://bknr.net/menu" - > - <head> - <title>BKNR - $(title)</title> - <link rel="stylesheet" type="text/css" href="/static/styles.css" /> - <script src="/static/javascript.js" language="javascript" type="text/javascript"> </script> - </head> - - <body> - <div id="banner"> - <div id="title">BKNR Lisp Application Environment</div> - <div id="logo"> - <a href="http://common-lisp.net/project/bknr/home.html" target="_new"> - <img width="88" height="31" alt="BKNR Logo" src="/image/bknr-logo" border="0" /> - </a> - </div> - </div> - <div id="body"> - <div id="system-column"> - <menu:site-menu config="menu.xml" - menu-name="main" - container-class="site-menu" - active-class="site-menu-active" - inactive-class="site-menu-inactive" /> - - </div> - <div id="content"> - <bknr:tag-body /> - </div> - </div> - </body> -</html> Deleted: trunk/projects/bknr-website/website/templates/user-error.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/user-error.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/user-error.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,14 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - xmlns:menu="http://bknr.net/menu" - > -Your request could not be processed because an error occured: -<pre> -$(error-message) -</pre> -</html> \ No newline at end of file Copied: trunk/projects/bknr-website/website/templates/user-error.xml (from rev 1800, trunk/projects/bknr-website/website/templates/user-error.bknr) Deleted: trunk/projects/bknr-website/website/templates/why-no-db.bknr =================================================================== --- trunk/projects/bknr-website/website/templates/why-no-db.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/why-no-db.bknr 2006-01-24 11:04:26 UTC (rev 1801) @@ -1,79 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<bknr:toplevel - template="toplevel" - title="BKNR technology" - xmlns="http://www.w3.org/1999/xhtml" - xmlns:bknr="http://bknr.net" - xmlns:bknr-website="http://bknr.net" - > - -<h1>Requirements for a persistence mechanism</h1> -<p> -We want a persistence mechanism which is closely integrated into our -programming language. Persistence is something we want to assume as -being available which writing applications, and it should be as -unintrusive as possible. Applications should use standard programming -language mechanisms to access all data. -</p> -<p> -The persistence mechanism should ensure that all appplication data in -the system is safe against system crashes. If the system crashes, the -application and all it's data should be restartable into a consistent -state. The amount of work which can be lost due to a unplanned system -failure should be low. -</p> -<p> -The persistence mechanism should make the amount of data which -constitutes the persistent state of the application transparent. It -should provide for mechanisms to duplicate the current state in order -to move it from one machine or software release to another. -</p> -<h1>Does a "Database system" help?</h1> -<p> -The two most popular database families today are relational databases -with SQL as query language, and embedded database facilities like -Berkeley DB which provides for indexed access to tables stored on -disk. They have in common that they assume that the primary location -of data is on-disk and that applications have to read and write data -from and to disk in order to perform their tasks. -</p> -<p> -Database systems, when they were invented, served as an address -extension to the applications. Applications could operate on data -sets which were to large for in-memory processing, providing -persistence at the same time. -</p> -<p> -In addition, SQL databases provide for a language neutral query -language that allow flexible querying of the application data. This -facility is useful in multi-language environments and to facilitate -database queries through third-party applications. -</p> -<p> -Todays main memories and processing speed redefine the environment in -which applications are created. Memory is no longer a very scarce -resource, and memory sizes have generally grown much faster than the -amount of application data that needs to be processed. Thus, -on-demand loading of application from disk can (and should) be totally -avoided by always having the complete data set in memory. -</p> -<h2>Properties of the BKNR persistence mechanism</h2> -<p> -All Disk access by the persistence mechanism is sequential. During -normal operation, the transaction log is sequentially appended to. -During snapshot, the snapshot file of the object subsystem is -sequentially written. During restore, the snapshot and transaction -log files are sequentially read. -</p> -<p> -All files used by BKNR are immutable. A file is never changed, but -only created, read or deleted. -</p> -<p> -The time needed to restore from a crash consists of the time needed to -read the sequential log file, to parse it's content and to execute the -applications' transaction code. -</p> -</bknr:toplevel> Copied: trunk/projects/bknr-website/website/templates/why-no-db.xml (from rev 1800, trunk/projects/bknr-website/website/templates/why-no-db.bknr) =================================================================== --- trunk/projects/bknr-website/website/templates/why-no-db.bknr 2006-01-24 08:48:40 UTC (rev 1800) +++ trunk/projects/bknr-website/website/templates/why-no-db.xml 2006-01-24 11:04:26 UTC (rev 1801) @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> +<?xml-stylesheet type="text/xsl" href="bknr.xsl" ?> +<page name="why-no-db"> + <h1>Requirements for a persistence mechanism</h1> + <p> + We want a persistence mechanism which is closely integrated into our + programming language. Persistence is something we want to assume as + being available which writing applications, and it should be as + unintrusive as possible. Applications should use standard programming + language mechanisms to access all data. + </p> + <p> + The persistence mechanism should ensure that all appplication data in + the system is safe against system crashes. If the system crashes, the + application and all it's data should be restartable into a consistent + state. The amount of work which can be lost due to a unplanned system + failure should be low. + </p> + <p> + The persistence mechanism should make the amount of data which + constitutes the persistent state of the application transparent. It + should provide for mechanisms to duplicate the current state in order + to move it from one machine or software release to another. + </p> + <h1>Does a "Database system" help?</h1> + <p> + The two most popular database families today are relational databases + with SQL as query language, and embedded database facilities like + Berkeley DB which provides for indexed access to tables stored on + disk. They have in common that they assume that the primary location + of data is on-disk and that applications have to read and write data + from and to disk in order to perform their tasks. + </p> + <p> + Database systems, when they were invented, served as an address + extension to the applications. Applications could operate on data + sets which were to large for in-memory processing, providing + persistence at the same time. + </p> + <p> + In addition, SQL databases provide for a language neutral query + language that allow flexible querying of the application data. This + facility is useful in multi-language environments and to facilitate + database queries through third-party applications. + </p> + <p> + Todays main memories and processing speed redefine the environment in + which applications are created. Memory is no longer a very scarce + resource, and memory sizes have generally grown much faster than the + amount of application data that needs to be processed. Thus, + on-demand loading of application from disk can (and should) be totally + avoided by always having the complete data set in memory. + </p> + <h2>Properties of the BKNR persistence mechanism</h2> + <p> + All Disk access by the persistence mechanism is sequential. During + normal operation, the transaction log is sequentially appended to. + During snapshot, the snapshot file of the object subsystem is + sequentially written. During restore, the snapshot and transaction + log files are sequentially read. + </p> + <p> + All files used by BKNR are immutable. A file is never changed, but + only created, read or deleted. + </p> + <p> + The time needed to restore from a crash consists of the time needed to + read the sequential log file, to parse it's content and to execute the + applications' transaction code. + </p> +</page> \ No newline at end of file

1 0

[Bknr-cvs] r1800 - trunk/bknr
by bknr＠bknr.net 24 Jan '06

24 Jan '06

Author: hhubner Date: 2006-01-24 02:48:40 -0600 (Tue, 24 Jan 2006) New Revision: 1800 Added: trunk/bknr/src/ Removed: trunk/bknr/base/ Log: rename base to src Copied: trunk/bknr/src (from rev 1796, trunk/bknr/base)

1 0

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

bknr-cvs January 2006