从头开始学Shark II

关注

原创最新推荐文章于 2026-11-12 21:44:19 发布 2k 阅读 AI 写同款· GEO 优化 ›

SpringBoot+Vue+MySQL 高校学科竞赛平台完整可运行版（源码+文档）本项目基于SpringBoot+Vue+MySQL构建高校学科竞赛管理平台，覆盖学生、教师、领队教师、管理员四大角色，实现竞赛发布、报名、刷题、评分、公示等全流程闭环管理。系统架构清晰，技术主流，配套完整源码、数据库脚本、万字论文、开题报告、答辩PPT及部署文档，支持一键运行，适用于毕业设计、课程设计及院系二次开发，真正实现“开箱即用”。阅读详情

从头开始学Shark II –

启动引擎和登陆

（宏云翻译，Cygnet开源工作流组， 2005-4-15 ）

原文地址：http://shark.objectweb.org/doc/sfs/sharkfromscratch2.html

在这篇文档中，我简单描述实例代码的创建。和以前一样，我不打算涉及和本文不直接相关的所有主题。首先，你必须了解如何去编写、编译和执行Java程序。另外，你需要有一个Shark的运行版，并且能够使用Shark提供的管理程序。

和以前一样，我已经安装了以下程序:

MySQL –我使用 4.0.16 -nt
MySQL Connector – 我使用mysql-connector-java- 3.0.11 -stable-bin.jar
Ant 1.6.x – 不是必需的，但是我提供了一个build file....
Java – 我使用Sun j2sdk version 1.4.2 _04
CVS, Winzip, 等其他需要的软件。

在执行以下命令后，我的Shark build安装在C:/Shark目录下

        make -install

我使用的策略是重复构造一些类（class）来示范如何在Shark中广泛使用。接口是Main method之外的一个命令行。这样做的目的是让新用户可以很容易地开始，并舒适地为Shark进行编码。

文件

你可以阅读这些文件，并且点击指向源码的链接，它是通过Java2html Java2Html ( www.java2html.com )产生的。另外，我已经提供了源码和Ant Build文件。可以在这里找到它们here.

开始使用Shark

开始使用Shark如下所示一样简单：

         Shark.configure(new Properties("Shark.conf"));

也就是说，首先要配置Shark (见Shark from Scratch(从头开始学习Shark))。那么，你需要确保所有的Jar文件都是可用的。我们这里构建的代码并不在Shark目录下。

能够启动Shark的最小jar文件集合是(根据我的配置):

C:/Shark/lib/sharkkernel-standard.jar
C:/Shark/lib/sharkclientapi.jar
C:/Shark/lib/sharkcommonapi.jar
C:/Shark/lib/sharkinternalapi.jar
C:/Shark/lib/sharkxpdl-standard.jar
C:/Shark/lib/sharkinstancepersistence-dods.jar
C:/Shark/lib/dods-runtime.jar
C:/Shark/lib/util.jar
C:/Shark/lib/sharkutilities-dods.jar
C:/Shark/lib/mysql-connector-java- 3.0.11 -stable-bin.jar
C:/Shark/lib/sharkrepositorypersistence-dods.jar
C:/Shark/lib/sharkscripting-standard.jar
C:/Shark/lib/sharkutilities-map.jar
C:/Shark/lib/sharkutilities-misc.jar
C:/Shark/lib/xercesImpl.jar
C:/Shark/lib/xml-apis.jar

构建实例

因为代码量很小, 所以我把它列到这里，让大家可以深入了解。当然，同时我提供了所有的源代码和一个脚本文件，见here. 这个例子在first 包中可以找到。

运行"ant -p"来看一下目标达成情况。如果你不是使用c:/Shark作为你的安装目录, 你必须在你的构建脚本文件中改变shark.dir的属性值。我们运行的类叫 Simple。

在运行之前，让我们来看看代码：

package first;

import org.enhydra.shark.Shark;

import java.util.Properties;

import java.io.FileInputStream;

/**

 * Does nothing more than start the Shark engine.

*/

public class Simple

   public static void main(String[] args)

try

         Properties props = new Properties();

         props.load(new FileInputStream("C://Shark//Shark.conf"));

         System.out.println("Enginename from Shark.conf is : " + props.getProperty("enginename"));

         // Make SURE every instance of shark that connects to the same database uses a different

         // enginename.

         props.setProperty("enginename", "rross");

         Shark.configure(props);

      catch (Exception e)

         // It's not like I am going to revive the thing if it crashes...

         e.printStackTrace();

代码相当简单，它实现装载properties文件，提供一个不同的引擎名称并把属性对象传递给Shark。

启动你的引擎

要运行它，只要在Dos命令中输入"ant runFirst"即可。当执行命令后，要看一下随后的输出

C:/dev/SharkFromScratch>ant runFirst

Buildfile: build.xml

runFirst:

     [java] Enginename from Shark.conf is : Shark

     [java] SharkEngineManager -> Shark engine is being initialized ...

     [java] File dodsConf.xml not exists on path: 'dodsconf' using default insted

     [java] Shark -> Initializing of shark engine has finished

     [java] Shark -> Initializing lasted 5 [s]

     [java] Shark -> firstEngine ready and waiting ...

BUILD SUCCESSFUL

Total time: 6 seconds

除了一个异常之外，其他都很正常。这个异常是“File dodsConf.xml not exists on path: 'dodsconf' using default insted"。忽略语法和拼写错误，就是说，不能找到dodsConf.xml的备份。如果我在Shark目录下做一个快速搜索，我能看到dodsConf.xml 确实存在。发生的问题是Shark.conf文件有一个缺省的相对路径，当你在包含build文件的目录（我这里是C:/dev/SharkfromScratch）下运行时，Shark能够找到所有的配置文件和其他信息。

修补配置文件

不是编辑硬盘上的Shark.conf文件，而是编辑在启动时传递给Shark引擎的各种属性。这使得我能够更好地控制什么会参与进来，使得我能够在应用（如runsa.bat）中继续使用“官方的（official）”Shark.conf文件，而不用经常改动它。

在交付给Shark之前，我会装载属性文件并预先考虑属性中所有相关文件名称的Shark安装目录。

在second.Simple中, 你能够看到上述情况。它并不是不可思议的，我已经硬编码了Shark的安装路径，它确实是完成了工作。

运行它，你会得到以下的输出(或者非常相似)

C:/dev/SharkFromScratch>ant runSecond

Buildfile: build.xml

runSecond:

     [java] Fixing up Shark config

     [java] SharkEngineManager -> Shark engine is being initialized ...

     [java] Shark -> Initializing of shark engine has finished

     [java] Shark -> Initializing lasted 5 [s]

     [java] Shark -> secondEngine ready and waiting ...

BUILD SUCCESSFUL

Total time: 6 seconds

正如你看到一样，Shark不再因为找不到dodsConf.xml文件而备受抱怨。在这一点上，我们正确启动了Shark。

深入钻研Shark

既然我们能够启动Shark，让我们来看一下我们能够得到什么。Third包是我们第一次尝试构建一个程序。Workflow类提供一个称作init的方法，这个方法包含了到目前为止我们已经做的工作。

在调用recreateDB之后，这个新的数据库实际上还没有任何用户，注意到这一点是很重要的。如果你还没有这样做，你可以运行Shark Swing应用程序(我这里是C:/Shark/runsa.bat)，并且使用用户名”admin”和密码"enhydra"登录。这样就会创建”admin”用户。实际上，如果你用未知的用户名登录Swing应用程序，它就会按照你提供的用户名和密码来创建一个新的用户