在 Visual Studio Code 的 OpenXava入门

创建新的项目

如果您还没在 Visual Studio Code 安装 Java 拓展包，可以到此处查看指南。

万事具备后，可以开始创建新的 OpenXava 项目，请按 F1 再按照下图：

现在项目已建成，您可以开始写代码了

创建第一个实体

开发应用程序非常简单：您只需要添加实体使您的应用程序扩展。
我们将从 Customer 简易版本开始，只有 number 和 name，选择 JAVA PROJECTS > src/main/java 的 com.yourcompany.invoicing.model 包并点击 + 。

再来在 Name 写下 Customer 为类名并按下 Enter。

注意 Customer 的"C"必须是大写，在 Java 所有类的开头都是大写。

Visual Studio Code 只提供最基本的代码：

package com.yourcompany.invoicing.model;
 
public class Customer {
 
}

现在您得把此类转换成适合 OpenXava 的实体。您只需要添加 @Entity 注解，之後是 number 和 name 属性

package com.yourcompany.invoicing.model;
 
import javax.persistence.*;

import org.openxava.annotations.*;

import lombok.*;
 
@Entity  // 这会把客户类标为实体
@Getter @Setter // 这让下面所有字段都可以被访问
public class Customer {
 
    @Id  // number属性是密钥，通常默认必须有密钥
    @Column(length=6)  // 列的长度会用在用户界面级（UI level）和数据库级（DB level）
    int number;
 
    @Column(length=50)  // 列的长度会用在用户界面级（UI level）和数据库级（DB level）
    @Required  // 如果 name 属性为空，將顯示錯誤
    String name;
 
}

现在您已有足够的代码（一个类）来运行应用程序。

运行应用程序

在首次运行应用程序之前，得先package ，如下：

点击 Run 按钮，等直到控制台显示“应用程序已启动”，如下：

现在您的应用程序已经在运行。请开启您的浏览器（Chrome, Firefox, Internet Explorer 11, Edge o Safari）并输入以下连结：

http://localhost:8080/invoicing

这是您第一次运行此应用程序，请点击登录按钮并在用户/密码中输入 admin/admin 再点击登录

在左边会有模块列表，选择客戶（Customers）

我们将使用客戶（Customers）模块来创建新的客户，只需要输入编号和名称并按下保存

点击列表可以察看已创建的客户。恭喜！您已成功运行第一个 OpenXava 应用程序。

修改应用程序

从现在开始，使用 OpenXava 开发应用变的非常容易。只需要编写一个类就可以马上在浏览器看到成果。
现在我们创建另一个实体为 Product，选择 com.yourcompany.invoicing.model 包，点击 + 按键并輸入 Product 再按下 Enter。

在 Product 里编写以下代码：

package com.yourcompany.invoicing.model;
 
import javax.persistence.*;
import org.openxava.annotations.*;
import lombok.*;
 
@Entity @Getter @Setter
public class Product {
 
    @Id @Column(length=9)
    int number;
 
    @Column(length=50) @Required
    String description;
 
}

现在按下 Run 按钮，这会重启应用程序

在您的浏览器输入以下网址来查看刚创建的实体：

http://localhost:8080/invoicing/modules/Product

使用 admin/admin 登录后将看到：

是的！您又成功运行新的模块了，而且只需编写一个相对简单的类。现在您只需要专注于扩展您的应用程序。

有任何问题吗？

恭喜！您已创建您的第一个 OpenXava 应用程序，若您在过程当中遇到任何问题，可以在论譠提问：

前往论譠

我们会帮助您解决。

接下来

这个使用 Visual Studio Code 的 OpenXava 入门教学是课程中的第一章，之后的课程都使用 Eclipse 并会教您如何使用 OpenXava 及其它 Java 相关技术、工具和框架开发企业应用程序。我们将从零开始一步一步的开发一个应用程序，该应用是个包含开发票、管理客户、产品等的小型应用。开发这应用程序是为了认识和学习业务程序中的典型案例，您可以将在开发票应用所学的内容应用到其它领域的其它业务应用中。

这是课程的内容：

入门：

第一章：入门教学 (您在这里)

使用 Java 建模：

继承：

基本业务逻辑：

高级验证：

完善默认行为：

第二十四章：改进标准行为

业务行为与逻辑：

第二十五章：行为与业务逻辑

注解与集合：

第二十六章：参照与集合

附录：

您已准备好进入下一章，但您也可以考虑阅读一些基础知识，例如：

如果您是 Java 新手，可以阅读一本介绍 Java 的书籍或 Java教程。
如果您对 OpenXava 的理念和架构感兴趣，阅读本课程的附录 A。
关于 Java Persistence API 和注解（annotations）的附录 B 和 C 对您会非常有用。

您想使用 IntelliJ、Maven、MySQL、PostgreSQL、Oracle、Microsoft SQL Server、AS/400、Informix、Db2 或 Firebird 吗? 您想要一个详细的参考指南吗？在 OpenXava 文檔中都找的到并且还有更多内容。

您准备好了吗？ 到第二章