au.gov.tas.dpiwe.mr.tool (Mr Architecture- API Documentation)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV PACKAGE NEXT PACKAGE

FRAMES NO FRAMES

Package au.gov.tas.dpiwe.mr.tool

The au.gov.tas.dpiwe.mr.tool package contains server monitor and control tools which can be run on clients, classes and interfaces supporting the deployment of Mr Architecture beans, including support classes for the Java close file format, as well as more general tools which allow the leverage of the Java close format in combination with Java language reflection to produce "instant wrappers".

See:
Description

Interface Summary
TreeParse.NodeFactory	A NodeFactory is a source of nodes with the ability to discriminate between the first and/or last lines of input.

Class Summary
AbstractBeanSourceFileStripper	AbstractBeanSourceFileStripper is currently a very primitive Java source file rewriter needed by the DeploymentContainer to ensure that abstract bean classes which are codependent with their or other beans' "Thin" entity bean implementations can be successfully compiled.
BatchFileCreator	This tool creates batch file versions of all shell scripts.
BeanFlusher	This utility can be used to flush bean types from server caches.
BeanPusher	This utility can be used to interact with beans in a general way.
Cat	This tool returns catalogue information for the files in named directories.
ClosedSourceFileWriter	ClosedSourceFileWriter takes a close source file, a set of global parameters, and a list of per key local parameters and produces a source file.
CodeMessageReporter	This tool examines all code files (including binary, Java, properties, CSV and XML files) looking for current message tokens and suggesting new message tokens: If a file is called "Messages" or has a .properties extension: The message tokens are added to the pool, and counted The message fragments themselves are also indexed If a file has a .java extension, it is searched for character strings: if any of these match a known token, this is counted if any of these match a known message fragment, this is reported all remaining strings are reported Files with .csv and .xml extensions are ignored.
CodeStripper	This tool strips a source file of all its statements.
CodeUnstripper	This tool replaces source files which have a counterpart with the suffix ".unstripped" with that counterpart.
DDLMapper	This tool takes two line by line comparable SQL DDL scripts: where the line contains the word "table", the next word is considered to be a table name, and a mapping is created from the word in the first file to the word in the second file.
DeMIME	This tool extracts all MIME sections from a file, using Mr Architecture's ByteCharTranscoder for base64 parts.
DeploymentContainer	DeploymentContainer is only used to create the source files used to deploy entity beans in other Containers.
DeploymentTool	This tool creates the source files needed to place EJBs in the ClientContainer and ServerContainer.
EntitySourceFileRewriter	EntitySourceFileRewriter is currently a very primitive Java/Groovy source file rewriter which can be used to comment out import lines of the form: import <subpackage of business object package> .
EntitySourceFileScanner	EntitySourceFileScanner is currently a very primitive Java/Groovy source file reader needed by the DeploymentTool to detect an application's persistent entities.
EnumDir	This tool enumerates the files in a single directory meeting a particular filename specification.
Ex	This tool returns extended catalogue information for the files in named directories.
HeaderReplacer	This tool adds a header to each source file where the first non-empty line is not the same as the first non-empty line of the header.
HeaderTool	This tool adds headers to files in a specified directory in accordance with a mapping in a specified properties file.
HistoryTool	This tool takes a Mr Architecture History file and interprets its meaning on standard output.
HomeSourceFileScanner	HomeSourceFileScanner is currently a very primitive Java source file reader needed by the DeploymentContainer to extract formal parameter lists from home interface source files.
HowMany	This tool counts how many entries are on a line or in a file.
HowMuch	This tool counts how many characters are on a line or bytes are in a file.
InSI	This tool takes a decimal number in exponential or floating point notation, as well as a base SI unit and converts into the nearest available SI unit.
JavaDocClassIndexMerger	This takes two HTML files produced by SinjDoc 0.5 to use as the main frame allclasses index and merges their entries.
JavaDocClassListMerger	This takes two HTML files produced by SinjDoc 0.5 to use as the allclasses frame and merges their entries.
LogWatcher	This tool takes a number of log filenames and permits the user to watch the ends of them, or step through from a particular time index.
MultiCat	This tool returns extended catalogue information for the files in multiple directories.
MultiCat.CatFile	A File which returns its extended catalogue information in response to a toString() call.
MultiCopy	This tool copies the files in multiple directories meeting the filename specification.
MultiCount	This tool counts the files in multiple directories meeting the filename specification.
MultiEnumDir	This tool enumerates the files in multiple directories meeting a particular filename specification.
MultiEx	This tool returns extended catalogue information for the files in multiple directories.
MultiEx.ExFile	A File which returns its extended catalogue information in response to a toString() call.
MultiNewer	This tool enumerates the newest files in multiple directories meeting a particular filename specification.
MultiNewer.NewerFile	A File which returns its modification date in response to a toString() call (in addition to its filename.)
MultiRename	This tool renames the files in multiple directories meeting the filename specification.
Newer	This tool enumerates the newest files in a single directory meeting a particular filename specification.
NullableMaker	This tool creates NullableObject source files.
NullMaker	This tool creates NullObject source files.
ObeyFileCreator	This tool creates obey file versions of all shell scripts.
RejarTool	This tool copies the classes in multiple jars which are listed in a dependency file.
SerializableMaker	This tool creates SerializableObject source files.
ServerHeimlicher	This utility can be used to restore a deadlocked server and/or retrieve active transaction profiling information.
ServerMonitor	This utility can be used to monitor the server and to restore the server should it become deadlocked.
ServerStatusTool	This utility can be used to report on the current transactions and daemons running on the server.
SourceFileRewriter	This tool rewrites all source files (including Java, properties, CSV and XML files) and CVS control files.
TableImporter	Takes a CSV (comma-separated value) file, first row assumed to be column names in a Mr Architecture bean type, or the words "ignore" or "temporary", and places beans in the table corresponding to each row.
TreeParse	TreeParse is a static class for retrieving items of text from an input stream for creation of a homogenous tree structure.
UUDecode	This tool extracts all UU-encoded sections from a file using Mr Architecture's ByteCharTranscoder.
UUEncode	This tool prints the rightful error message to people who think UU-encoding is still a good idea.
WithdrawalTool	This tool displaces all source files beginning with the prefix Mr or Thin in a directory or group of directories.
WrapperMaker	This tool creates ObjectWrapper source files.
XMap	This tool blindly replaces text in accordance with a mapping in a specified properties file.
ZipMerger	This tool zipmerges two files of ordered entries to produce a third file.

Package au.gov.tas.dpiwe.mr.tool Description

The foremost tool is the DeploymentTool, which you will need in order to deploy bean implementations for your application. WithdrawalTool, CodeStripper and CodeUnstripper are useful in allowing applications to be compiled from scratch- see Application Note #6.

The server monitor tools are ServerMonitor and ServerStatusTool. The ServerMonitor provides an interactive display with server statistics, while the ServerStatusTool is run once and takes a snapshot of the commands and daemons running on the server at a particular point in time.

The individual control functions of the ServerMonitor can be accomplished by the individual tools DaemonStarter, DaemonStopper, BeanFlusher and ServerHeimlicher.

The daemon control tools DaemonStarter and DaemonStopper are in the package au.gov.tas.dpiwe.server.daemon.

The general tools which produce "instant wrappers" are useful in a number of situations:

Where, due to sheer bloody-mindedness, Sun or some other party has developed a final class or a class with some usefully overridden methods final. In this case an "instant subclass" is useful to create a new class which, while disjoint from the old class, has all the same functionality but is not final. WrapperMaker is useful here. NullableMaker is a more specific application of the same idea.
Where, due to lack of forethought, Sun or some other party has developed a final class which is not serializable. In this case an "instant wrapper" is useful to create a new class which, while disjoint from the old set of class, has all the same functionality except that it is now serializable. SerializableMaker is useful here.

Since:

Mr Architecture 1.0

Author:

Mr Architecture — an EJB 2.1 subset with relational and other extensions
by Kade Hansson <kade.hansson@dpiwe.tas.gov.au>

Mr Architecture is a not-for-profit project of DPIWE Tasmania. Its code is distributed under the terms of the Lesser GNU Public License (LGPL), either version 2.1 or a later version (at your option.) A copy should have been provided with this distribution, but a copy can be obtained on the web at http://www.gnu.org/licenses/lgpl.html or by writing to:

Free Software Foundation, Inc
59 Temple Place
Suite 330
Boston, MA 02111-1307
USA

Mr Architecture is supplied "as is" without any warranty whatsoever, and should therefore be considered to be without any implied warranty of merchantability or fitness for any particular purpose. See the Lesser GNU Public License (LGPL) for details.

Sun hereby grants Doug Lea a non-exclusive, worldwide, non-transferrable license to use, reproduce, create derivative works of, and distribute the Java software and derivative works thereof in source and binary forms as part of a larger work, and to sublicense the right to use, reproduce and distribute the Java Software and Doug Lea's derivative works as the part of larger works through multiple tiers of sublicensees provided that the following conditions are met:

Neither the name of or any trademarks of Sun may be used to endorse or promote products including or derived from the Java Software technology without prior specific written permission; and
Redistributions of the source or binary code must contain the above copyright notice, this notice and the following disclaimers.

[The concurrent collections framework] is provided "as is," without warranty of any kind. All express or implied conditions, representations or warranties, including any implied warranty of merchantability, fitness for a particular purpose or non-infringement, are hereby excluded. [Sun] and its licensors shall not be liable for any damages suffered by [a] licensee as a result of using, modifying or distributing the [concurrent collections framework] or its derivatives. In no event will [Sun] or its licensors be liable for any lost revenue, profit or data, or for direct, indirect, special, consequential, incidental or punitive damages, however caused and regardless of the theory of liability, arising out of the use of or inability to use [the concurrent collections framework], even if [Sun] has been advised of the possibility of such damages.

You acknowledge that [the concurrent collections framework] is not designed, licensed or intended for use in the design, construction, operation or maintenance of any nuclear facility.