openxava / 文档 / OpenXava 与 LeanXcale

目录

LeanXcale 是什么?
注册 LeanXcale
OpenXava 是什么?
注册并下载 OpenXava Studio
创建 OpenXava 新项目
配置 OpenXava 以使用 LeanXcale
重建项目
运行应用程序

LeanXcale 是什么?

LeanXcale 是一个 ACID 数据库引擎,可以从单个节点线性灵活地扩展到数百个节点,并拥有一个具有个位数毫秒延迟的键值 API,并在大容量下保持相同的性能。
LeanXcale 可以随着您的业务增长而线性扩展,从 MVP 到全球部署;另外还提供了一个快速灵活的平台,可以 360 度全方位查看所有可用信息。

注册 LeanXcale

LeanXcale 有试用版而且无需提供任何信息。您只需要在此处使用您的电子邮件注册
leanxcale-configuration_es10.png
几分钟后,您将收到一封激活试用版的电子邮件,点击后会将您带到 LeanXcale 平台。

OpenXava 是什么?

OpenXava 是一个高生产力的 Java 开源框架,专注于开发多平台的企业 Web 应用程序,且几乎支持所有关系数据库。

注册并下载 OpenXava Studio

OpenXava 是免费的,您可以在此处注册并下载 Studio,或者您可以在其他 IDE 使用 Maven,如在 IntelliJ、VSC。 在注册后,您将收到一封电子邮件,其中包含下载的链接,以下面我们将使用此 IDE。
leanxcale-configuration_en20.png

创建 OpenXava 新项目

首先,点击 OpenXava > New OpenXava Project 并在视窗输入 :
leanxcale-configuration_en30.png
打开 src/main/java 文件夹,选择 com.yourcompany.invoicing.model 包并点击 New Java Class 按钮:
getting-started_es125.png
再来在 Name 写下 Customer 为类名并按下 Finish。
注意 Customer 的"C"必须是大写,在 Java 所有类的开头都是大写。
getting-started_es130.png
在 Customer 贴上以下代码:
package com.yourcompany.invoicing.model;
 
import javax.persistence.*;
import org.openxava.annotations.*;
import lombok.*;
 
@Entity  
@Getter @Setter 
public class Customer {
 
    @Id  
    @Column(length=6)  
    int number;
 
    @Column(length=50) 
    @Required 
    String name;
 
}

配置 OpenXava 以使用 LeanXcale

编辑项目根文件夹中的 pom.xml 文件,在 <dependencies> 中添加:
<dependency>
	<groupId>com.leanxcale</groupId>
	<artifactId>qe-driver</artifactId>
	<version>1.9.4</version>
</dependency>

<dependency>
	<groupId>com.leanxcale.connectors</groupId>
	<artifactId>hibernate-connector</artifactId>
	<version>1.9.4</version>
</dependency>
在同个文件中的 <repositories> 添加以下:
<repository>
	<id>maven-releases</id>
	<url>https://nexus.leanxcale.com/repository/maven-releases</url>
</repository>
添加后大约是这样:
leanxcale-configuration_es50.png 
另外在 src/main/resources/META-INF 文件夹中的 persistence.xml 里添加:
<properties>
      <!-- ... -->
      <property name="hibernate.dialect" value="com.leanxcale.connector.hibernate.LxDialect"/>
      <property name="hibernate.globally_quoted_identifiers" value="true"/>
</properties>
leanxcale-configuration_es60.png
现在到 LeanXcale 平台,在“How To Connect”页面复制 url:
leanxcale-configuration_es70.png
然后编辑位于 src/main/webapp/MEFA-INF 文件夹中的 context.xml 文件:
<Resource name="jdbc/invoicingDS" auth="Container" type="javax.sql.DataSource"
	  maxTotal="20" maxIdle="5" maxWaitMillis="10000"
	  username="app" password="app" 
	  driverClassName="com.leanxcale.client.Driver"
	  url="jdbc:leanxcale://a5357d898f9318f2a75b.lxc-db.com:1522/db"/>
显然,您必须更改的是用户、密码(如果您使用的是试用版,用户/密码为“app”),在 URL 中贴上您在 LeanXcale 平台上复制的那个。
leanxcale-configuration_en80.png

重建项目

做完所有更改后,必须重建项目。在您的项目上點击右键,然后选择 Run As > Maven install:

优化小纸条:您可以使用 mvn war:exploded 代替 mvn install 进行完整的 Maven 构建,足以在開發環境中使用上面所有的更改。点击 Run As > Maven build 并在 goals 输入 war:exploded。

运行应用程序

点击 Run 按钮,等直到控制台显示“应用程序已启动”,如下:
getting-started_es150.png
getting-started_es155.png
现在您的应用程序已经在运行。请开启您的浏览器(Chrome, Firefox, Internet Explorer 11, Edge o Safari)并输入以下连结:

    http://localhost:8080/invoicing

这是您第一次运行此应用程序,请点击登录按钮并在用户/密码中输入 admin/admin 再点击登录
getting-started_es160.png
Página de identificación
在左边会有模块列表,选择客戶(Customers)
getting-started_es170.png
点击 列表 可以察看已创建的客户。恭喜!您已成功运行第一个 OpenXava 应用程序。
getting-started_es190.png

您喜欢 OpenXava 吗? 我们邀请您至课程第一章
使用 OpenXava 时碰到什么问题吗? 前往论坛