Mercurial > hg > tema

view misc/biotopes/doc/readme.html @ 30:54539dff18ca

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Allow access to the calling (outer) context. Start parse_args implementation.
author Mikhail Kryshen <mikhail@kryshen.net>
date Fri, 15 May 2009 03:07:16 +0400 (2009-05-14)
parents 6c41a0b43e58
children
line wrap: on
line source
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
          "DTD/xhtml1-transitional.dtd">

<html>

<head>
  <title>DbReader</title>
  <meta http-equiv="Content-Type" content="text/html; charset=koi8-r" />
</head>

<body>
<h1>DbReader</h1>

<h2>õÓÔÁÎÏ×ËÁ ÐÒÏÇÒÁÍÍÙ</h2>
<ol>
<li>òÁÓÐÁËÏ×ÁÔØ ÁÒÈÉ×.</li>

<li>õÓÔÁÎÏ×ÉÔØ ÉÓÔÏÞÎÉË ÄÁÎÎÙÈ:<br />
× Windows 2000: ðÁÎÅÌØ ÕÐÒÁ×ÌÅÎÉÑ/áÄÍÉÎÉÓÔÒÉÒÏ×ÁÎÉÅ/éÓÔÏÞÎÉËÉ ÄÁÎÎÙÈ (ODBC), ÄÏÂÁ×ÉÔØ biotopes-data.mdb.</li>

<li>îÁÓÔÒÏÉÔØ ÐÒÏÇÒÁÍÍÕ:<br />
÷ ÆÁÊÌÅ dbreader.properties ÕËÁÚÁÔØ ÉÍÑ, ÐÒÉÓ×ÏÅÎÎÏÅ ÉÓÔÏÞÎÉËÕ ÄÁÎÎÙÈ:<br />
    <code>resource: jdbc:odbc:<em>ÉÍÑ</em></code><br />
É ÐÕÔØ Ë ËÁÔÁÌÏÇÕ, ÏÔÎÏÓÉÔÅÌØÎÏ ËÏÔÏÒÏÇÏ ÐÒÏÇÒÁÍÍÁ ÂÕÄÅÔ ÉÓËÁÔØ ÉÚÏÂÒÁÖÅÎÉÑ (ÓÏÄÅÒÖÁÝÉÊ biotopephotos É maps):<br />
    <code>resource_base: C:\\biotopes</code><br />
(ÓÉÍ×ÏÌ '\' ÎÅÏÂÈÏÄÉÍÏ ÄÕÂÌÉÒÏ×ÁÔØ)</li>

<li>úÁÐÕÓË ÐÒÏÇÒÁÍÍÙ:<br />
<code>dbreader.bat</code> ÉÌÉ<br />
<code>java -jar dbreader.jar</code>.<br />
äÌÑ ÚÁÐÕÓËÁ ÎÅÏÂÈÏÄÉÍÁ Java Runtime Environment (JRE) 5.0, ÍÏÖÎÏ ÓËÁÞÁÔØ Ó <a href="http://java.sun.com/j2se/1.5.0/download.jsp">http://java.sun.com/j2se/1.5.0/download.jsp</a>. ÷ÏÚÍÏÖÎÏ, ÂÕÄÅÔ ÒÁÂÏÔÁÔØ É ÓÏ ÓÔÁÒÙÍÉ ×ÅÒÓÉÑÍÉ JRE - ÎÅ ÐÒÏ×ÅÒÑÌ.

÷ÓÅ ÚÎÁÞÅÎÉÑ ÆÁÊÌÁ ËÏÎÆÉÇÕÒÁÃÉÉ ÍÏÖÎÏ ÐÅÒÅÏÐÒÅÄÅÌÑÔØ ÐÒÉ ÚÁÐÕÓËÅ ÐÒÏÇÒÁÍÍÙ:<br />
ËÏÍÁÎÄÁ <code>java -Dru.karrc.dbreader.<em>ËÌÀÞ</em>=<em>ÚÎÁÞÅÎÉÅ</em> -jar dbreader.jar</code><br />
(ÎÁÐÒÉÍÅÒ: <code>java -Dru.karrc.dbreader.log=dbreader.log -jar dbreader.jar</code>)</li>
</ol>

<h2>òÁÂÏÔÁ ÐÒÏÇÒÁÍÍÙ</h2>

<p>ðÒÏÇÒÁÍÍÁ ×ÙÐÏÌÎÑÅÔ ÚÁÐÒÏÓ biotope.sql (ÉÌÉ ÄÒÕÇÏÊ, ÕËÁÚÁÎÎÙÊ × dbreader.properties), ÐÏÓÌÅ ÞÅÇÏ ÏÂÒÁÂÁÔÙ×ÁÅÔ ÆÁÊÌ biotope.template, ÚÁÍÅÎÑÑ ÎÁÊÄÅÎÎÙÅ × ÎÅÍ ÉÎÓÔÒÕËÃÉÉ ÎÁ ÒÅÚÕÌØÔÁÔÙ ÉÈ ×ÙÐÏÌÎÅÎÉÑ.</p>
<p>æÏÒÍÁÔ ÉÎÓÔÒÕËÃÉÊ: <code>&lt;%<em>ÓÐÉÓÏË_ÆÕÎËÃÉÊ</em>[:|\]<em>ÄÁÎÎÙÅ</em>%&gt;</code>, <em>ÓÐÉÓÏË ÆÕÎËÃÉÊ</em> - ÉÍÅÎÁ ÆÕÎËÃÉÊ ÒÁÚÄÅÌÅÎÎÙÅ ÐÒÏÂÅÌÏÍ, ÓÐÉÓÏË ÍÏÖÅÔ ÂÙÔØ ÐÕÓÔÙÍ. åÓÌÉ ÕËÁÚÁÎÏ ÎÅÓËÏÌØËÏ ÆÕÎËÃÉÊ, ÏÎÉ ×ÙÐÏÌÎÑÀÔÓÑ ÎÁÞÉÎÁÑ Ó ÐÏÓÌÅÄÎÅÊ.</p>

<h3>òÁÚÄÅÌÉÔÅÌÉ ÍÅÖÄÕ ÓÐÉÓËÏÍ ÆÕÎËÃÉÊ É ÄÁÎÎÙÍÉ</h3>

<ul>
  <li><code>:</code> - ÄÁÎÎÙÅ ÂÕÄÕÔ ÏÂÒÁÂÁÔÙ×ÁÔØÓÑ ÒÅËÕÒÓÉ×ÎÏ.</li>
  <li><code>\</code> - ÄÁÎÎÙÅ ÂÕÄÕÔ ÐÅÒÅÄÁÎÙ ÆÕÎËÃÉÉ ÂÅÚ ÏÂÒÁÂÏÔËÉ. íÏÖÎÏ ÉÓÐÏÌØÚÏ×ÁÔØ ÄÌÑ ÜËÒÁÎÉÒÏ×ÁÎÉÑ ËÏÍÂÉÎÁÃÉÊ ÓÉÍ×ÏÌÏ× <code>&lt;%</code> É <code>%&gt;</code> (<code>&lt;%\&lt;%%&gt;</code> É <code>&lt;%\%%&gt;&gt;</code>).</li>
</ul>

<h3>æÕÎËÃÉÉ</h3>

<ul>
  <li><code>&lt;%get:<em>ÉÍÑ</em>%&gt;</code><br />
  úÁÍÅÎÑÅÔÓÑ ÎÁ ÚÎÁÞÅÎÉÅ ×ÓÔÒÏÅÎÎÏÊ ÐÅÒÅÍÅÎÎÏÊ ÉÌÉ ËÏÌÏÎËÉ ÚÁÐÒÏÓÁ.</li>

  <li><code>&lt;%optional:<em>ÔÅËÓÔ</em>%&gt;</code><br />
  úÁÍÅÎÑÅÔÓÑ ÎÁ <em>ÔÅËÓÔ</em>, ÅÓÌÉ × ÎÅÍ ÎÁÊÄÅÎÙ ÉÎÓÔÒÕËÃÉÉ, ÚÁÍÅÎÉ×ÛÉÅÓÑ ÎÁ ÎÅÐÕÓÔÙÅ ÓÔÒÏËÉ, ÉÎÁÞÅ ÚÁÍÅÎÑÅÔÓÑ ÎÁ ÐÕÓÔÕÀ ÓÔÒÏËÕ.</li>

  <li><code>&lt;%escape:<em>ÔÅËÓÔ</em>%&gt;</code><br />
  úÁÍÅÎÑÅÔ × ÔÅËÓÔÅ "ÏÐÁÓÎÙÅ" ÓÉÍ×ÏÌÙ (ÔÁÂÌÉÃÁ ÚÁÍÅÎ ÚÁÄÁÅÔÓÑ × ÆÁÊÌÅ ËÏÎÆÉÇÕÒÁÃÉÉ).</li>

  <li><code>&lt;%invoke:<em>ÉÍÑ</em>; <em>ÐÁÒÁÍ1</em> <em>ÐÁÒÁÍ2</em> ... <em>ÐÁÒÁÍN</em>%&gt;</code><br />
  ÷ÙÐÏÌÎÑÅÔ ÚÁÐÒÏÓ Ó ÐÁÒÁÍÅÔÒÁÍÉ <em>ÉÍÑ</em>.sql É ÚÁÍÅÎÑÅÔÓÑ ÎÁ ÒÅÚÕÌØÔÁÔÙ ÏÂÒÁÂÏÔËÉ ÛÁÂÌÏÎÁ <em>ÉÍÑ</em>.template. úÎÁÞÅÎÉÑ ÐÁÒÁÍÅÔÒÏ× ÐÏÄÓÔÁ×ÌÑÀÔÓÑ × ÚÁÐÒÏÓ ×ÍÅÓÔÏ ÓÉÍ×ÏÌÁ '?'.</li>

  <li><code>&lt;%image:<em>ÉÓÈ_ÆÁÊÌ</em> <em>ËÏÎ_ÆÁÊÌ</em> <em>ÆÏÒÍÁÔ</em> [<em>ÍÁËÓ_ÛÉÒÉÎÁ</em>] [<em>ÍÁËÓ_×ÙÓÏÔÁ</em>]%&gt;</code><br />
  úÁÇÒÕÖÁÅÔ ÉÚÏÂÒÁÖÅÎÉÅ ÉÚ ÆÁÊÌÁ <em>ÉÓÈ_ÆÁÊÌ</em> (ÐÕÔØ ÏÐÒÅÄÅÌÑÅÔÓÑ ÏÔÎÏÓÉÔÅÌØÎÏ ËÏÎÆÉÇÕÒÁÃÉÏÎÎÏÇÏ ÐÁÒÁÍÅÔÒÁ "resource_base") É ÐÒÅÏÂÒÁÚÕÅÔ ÅÇÏ × ÕËÁÚÁÎÎÙÊ ÆÏÒÍÁÔ, ÓÏÈÒÁÎÑÑ ÒÅÚÕÌØÔÁÔ × <em>ËÏÎ_ÆÁÊÌ</em>. åÓÌÉ ÚÁÄÁÎÙ ÍÁËÓÉÍÁÌØÎÁÑ ×ÙÓÏÔÁ É ÛÉÒÉÎÁ, ÂÏÌØÛÉÅ ÉÚÏÂÒÁÖÅÎÉÑ ÂÕÄÕÔ ÕÍÅÎØÛÅÎÙ.
ðÒÉ ÕÓÐÅÛÎÏÍ ×ÙÐÏÌÎÅÎÉÉ, ÉÎÓÔÒÕËÃÉÑ <code>&lt;%image:...%&gt;</code> ÂÕÄÅÔ ÚÁÍÅÎÅÎÁ ÎÁ ÚÎÁÞÅÎÉÅ <em>ËÏÎ_ÆÁÊÌ</em>, ÉÎÁÞÅ - ÎÁ ÐÕÓÔÕÀ ÓÔÒÏËÕ.</li>

  <li><code>&lt;%copy:<em>ÉÓÈ_ÆÁÊÌ</em> <em>ËÏÎ_ÆÁÊÌ</em>%&gt;</code><br />
  ëÏÐÉÒÕÅÔ ÆÁÊÌ <em>ÉÓÈ_ÆÁÊÌ</em> (ÐÕÔØ ÏÐÒÅÄÅÌÑÅÔÓÑ ÏÔÎÏÓÉÔÅÌØÎÏ ËÏÎÆÉÇÕÒÁÃÉÏÎÎÏÇÏ ÐÁÒÁÍÅÔÒÁ "resource_base") × <em>ËÏÎ_ÆÁÊÌ</em>. ðÒÉ ÕÓÐÅÛÎÏÍ ×ÙÐÏÌÎÅÎÉÉ, ÉÎÓÔÒÕËÃÉÑ <code>&lt;%copy:...%&gt;</code> ÂÕÄÅÔ ÚÁÍÅÎÅÎÁ ÎÁ ÚÎÁÞÅÎÉÅ <em>ËÏÎ_ÆÁÊÌ</em>, ÉÎÁÞÅ - ÎÁ ÐÕÓÔÕÀ ÓÔÒÏËÕ.</li>
</ul>

<h3>÷ÓÔÒÏÅÎÎÙÅ ÐÅÒÅÍÅÎÎÙÅ</h3>

<p><code>NUMBER</code> - ÐÏÒÑÄËÏ×ÙÊ ÎÏÍÅÒ ÓÔÒÏËÉ ÒÅÚÕÌØÔÁÔÁ ×ÙÐÏÌÎÅÎÉÑ ÚÁÐÒÏÓÁ.
þÔÏÂÙ ÏÂÒÁÔÉÔØÓÑ Ë ÐÅÒÅÍÅÎÎÏÊ ÚÁÐÒÏÓÁ, ÉÚ ËÏÔÏÒÏÇÏ ÏÂÒÁÂÁÔÙ×ÁÅÍÙÊ ÛÁÂÌÏÎ ÂÙÌ ×ÙÚ×ÁÎ Ó ÐÏÍÏÝØÀ ÆÕÎËÃÉÉ invoke, ÐÅÒÅÄ ÉÍÅÎÅÍ ÐÅÒÅÍÅÎÎÏÊ ÎÕÖÎÏ ÄÏÂÁ×ÉÔØ <code>SUPER.</code> (ÎÁÐÒÉÍÅÒ: <code>SUPER.NUMBER</code>).</p>

<h3>ðÒÉÍÅÒ</h3>

<p>óÌÅÄÕÀÝÁÑ ÉÎÓÔÒÕËÃÉÑ ÐÏÌÕÞÉÔ ÚÎÁÞÅÎÉÅ ÉÚ ÓÔÏÌÂÃÁ name É ÚÁÍÅÎÉÔ × ÎÅÍ ÓÐÅÃÉÁÌØÎÙÅ ÓÉÍ×ÏÌÙ:</p>
<p><code>&lt;%escape get:name%&gt;</code></p>

<p align="right"><i><a href="mailto:kryshen@cs.karelia.ru">íÉÈÁÉÌ ëÒÙÛÅÎØ</a></i></p>

</body>
</html>