java EE技术体系——CLF平台API开发注意事项(1)——后端开发
2017-08-30 12:19
471 查看
前言:这是一篇帮助小伙伴在本次项目中快速进入到java EE开发的一些说明,为了让同组小伙伴们开发的时候,有个清晰点的思路。昨天给大家演示分享了基本概况,但没有留下文字总结说明,预防后期有人再次问我,特写此篇博客!
本篇博客的结构主要分为两个部分:第一个是关键执行点,也就是在项目中,每个人都要去做去注意的;第二个是其他注意点,这个部分是一些大家提到的问题
并在实现类上使用@Transactional注解(注意这里的proxy-target-class=“true”,标志使用CGlib代理)
小伙伴们:着重关注第二点内容,涉及到咱们的具体使用!
在咱们的项目中,第一点:了解事务的基础内容:https://docs.oracle.com/javase/tutorial/jdbc/basics/transactions.html
第二点:了解JTA(java transaction api)的基本用法:http://docs.oracle.com/javaee/7/api/javax/transaction/package-summary.html (要求,在本项目中,准确指定Exception类型(Exception
summary)及其对应的事务回滚操作(Annotation types summary)) 第三点:维基百科中对于JTA的说明:https://en.wikipedia.org/wiki/Java_Transaction_API#.40Transactional_annotation
在entitymanager中,提供了很多的接口,有一些是直接传入实体类型就可用。而有一些,则是提供接口进行扩展。结合到咱们的业务,我们会需要创建自己的SQL语句,去查询相关的数据,那么在此,我说明一下相关用法:
第一,执行咱们自建的SQL有两种方法:a,使用JPQL进行查询;b,使用原生SQL
先说简单的原生SQL:可供选择的接口有:
而使用JPQ语句,可供选择的接口有:
当咱们的业务需要执行自定义SQL查询到 时候,这两种方式,在项目的Repository层,自行选择一种进行实现。
接下来,介绍一下相对不熟悉的JPQ,着重说明一下NameQuery。备注:为了便于管理统计,只自己使用的接口,一律写在Repository层,而被多次(自己及他人)使用的,一律写在Entity层,并加注所属实体,例如:TOpinion.findByStatus
第一点:NameQuery的所在地方,有两个,第一种用法:
两种赋值方式:query.setParameter(1, "2"); 和 query.setParameter("status", status.get(0));
扩展学习链接:http://www.objectdb.com/java/jpa/query/named
在项目中,没有明确配置数据库连接池,但是,这不代表,我们没有连接池,只不过,我们的数据库连接池,配置在Jboss里面。有兴趣的可以看看配置文件中对于数据库的配置信息
2,事务的执行策略和传播行为
这一点,也在Jboss里面呢,项目中并没有配置
3,怎样快速构建的后端工程
这一点我专门写篇博客或者文档,说明一下操作过程,以及前后两种开发模式的效率对比说明
4,swagger在这之中所做的工作
同第三点,我会再写篇博客,关于swagger编辑器,swagger API发布,swagger API代码生成,借助swagger构建可访问的mock service,API集成其他工具快速构建开发框架
后续关于安全控制,测试框架Arquillian的使用,再出文档!
本篇博客的结构主要分为两个部分:第一个是关键执行点,也就是在项目中,每个人都要去做去注意的;第二个是其他注意点,这个部分是一些大家提到的问题
一、关键执行点
重中之重:严禁引入任何Spring体系的技术(关于昨天提到的 定时任务,消息,java EE有相应的技术体系)1.1,事务
与Spring不同,在Spring中咱们需要配置:<!-- 对数据源进行事务管理 --> <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource"/> </bean> <tx:annotation-driven transaction-manager="transactionManager" proxy-target-class="true"/> <aop:aspectj-autoproxy/>
并在实现类上使用@Transactional注解(注意这里的proxy-target-class=“true”,标志使用CGlib代理)
小伙伴们:着重关注第二点内容,涉及到咱们的具体使用!
在咱们的项目中,第一点:了解事务的基础内容:https://docs.oracle.com/javase/tutorial/jdbc/basics/transactions.html
第二点:了解JTA(java transaction api)的基本用法:http://docs.oracle.com/javaee/7/api/javax/transaction/package-summary.html (要求,在本项目中,准确指定Exception类型(Exception
summary)及其对应的事务回滚操作(Annotation types summary)) 第三点:维基百科中对于JTA的说明:https://en.wikipedia.org/wiki/Java_Transaction_API#.40Transactional_annotation
1.2,JPQL使用
备注:底层的实现框架,目前选择的是EclipseLink。在entitymanager中,提供了很多的接口,有一些是直接传入实体类型就可用。而有一些,则是提供接口进行扩展。结合到咱们的业务,我们会需要创建自己的SQL语句,去查询相关的数据,那么在此,我说明一下相关用法:
第一,执行咱们自建的SQL有两种方法:a,使用JPQL进行查询;b,使用原生SQL
先说简单的原生SQL:可供选择的接口有:
public Query createNativeQuery(String sqlString); public Query createNativeQuery(String sqlString, Class resultClass); public Query createNativeQuery(String sqlString, String resultSetMapping); public StoredProcedureQuery createNamedStoredProcedureQuery(String name); public StoredProcedureQuery createStoredProcedureQuery(String procedureName); public StoredProcedureQuery createStoredProcedureQuery(String procedureName, Class[] resultClasses); public StoredProcedureQuery createStoredProcedureQuery(String procedureName, String[] resultSetMappings);
而使用JPQ语句,可供选择的接口有:
public Query createQuery(String qlString); public <T extends Object> TypedQuery<T> createQuery(CriteriaQuery<T> criteriaQuery); public Query createQuery(CriteriaUpdate updateQuery); public Query createQuery(CriteriaDelete deleteQuery); public <T extends Object> TypedQuery<T> createQuery(String qlString, Class<T> resultClass); public Query createNamedQuery(String name); public <T extends Object> TypedQuery<T> createNamedQuery(String name, Class<T> resultClass);
当咱们的业务需要执行自定义SQL查询到 时候,这两种方式,在项目的Repository层,自行选择一种进行实现。
接下来,介绍一下相对不熟悉的JPQ,着重说明一下NameQuery。备注:为了便于管理统计,只自己使用的接口,一律写在Repository层,而被多次(自己及他人)使用的,一律写在Entity层,并加注所属实体,例如:TOpinion.findByStatus
第一点:NameQuery的所在地方,有两个,第一种用法:
/** * JPA第一种NameQuery语句写法 */ public void exampleForNameQuery() { Query query = this.em.createNamedQuery("select * from TOpinion o where o.id=?"); List<TOpinion> opinion = query.getResultList(); System.out.println(opinion.get(0).getContent()); }也就是说,直接在Repository层编辑,第二种,在实体上统一编辑,然后调用,这一点类似于Mybatis的调用层次:
@Entity @Table(name = "t_opinion") @NamedQueries({ @NamedQuery(name = "TOpinion.findById", query = "SELECT o FROM TOpinion o WHERE o.id=?1") , @NamedQuery(name = "TOpinion.findByStatus", query = "SELECT o FROM TOpinion o WHERE o.status=:status") }) public class TOpinion implements Serializable { @Column(name = "id", table = "t_opinion", nullable = false, length = 22) @Id private String id;调用:
/** * JPA第二种NameQuery语句写法,赋值方式参考Hibernate,调用结构参考Mybatis */ public void exampleForNameQuery1() { Query query = em.createNamedQuery("TOpinion.findById"); query.setParameter(1, "2"); List<TOpinion> opinion = query.getResultList(); }
两种赋值方式:query.setParameter(1, "2"); 和 query.setParameter("status", status.get(0));
扩展学习链接:http://www.objectdb.com/java/jpa/query/named
1.3,关于注入
在Spring中,咱们使用@Autowired进行bean注入,在此项目中,咱们使用的是Jboss实现的CDI规范,应该使用@Inject注入!二、其他注意点
1,数据库连接池在项目中,没有明确配置数据库连接池,但是,这不代表,我们没有连接池,只不过,我们的数据库连接池,配置在Jboss里面。有兴趣的可以看看配置文件中对于数据库的配置信息
2,事务的执行策略和传播行为
这一点,也在Jboss里面呢,项目中并没有配置
3,怎样快速构建的后端工程
这一点我专门写篇博客或者文档,说明一下操作过程,以及前后两种开发模式的效率对比说明
4,swagger在这之中所做的工作
同第三点,我会再写篇博客,关于swagger编辑器,swagger API发布,swagger API代码生成,借助swagger构建可访问的mock service,API集成其他工具快速构建开发框架
三、总结
平台的开发模式,开发技术,都跟之前的Spring有所微小差异,但对于大家来说,一切都不是问题,从目前的现况来看,接收速度和效率都很不错。很开心啊后续关于安全控制,测试框架Arquillian的使用,再出文档!
相关文章推荐
- java EE技术体系——CLF平台API开发注意事项(1)——后端开发
- java EE技术体系——CLF平台API开发注意事项(2)——后端测试
- java EE技术体系——CLF平台API开发注意事项(2)——后端测试
- java EE技术体系——CLF平台API开发注意事项(4)——API生命周期治理简单说明
- java EE技术体系——CLF平台API开发注意事项(4)——API生命周期治理简单说明
- java EE技术体系——CLF平台API开发注意事项(3)——API安全访问控制
- java EE技术体系——CLF平台API开发注意事项(3)——API安全访问控制
- 64位平台C/C++开发注意事项
- Android 平台上蓝牙开发的关于 UUID 设置的注意事项
- 实施软件平台与框架开发的注意事项
- 实施软件平台与框架开发的注意事项
- 微信在android平台上开发的注意事项(以官方提供的demo为例):
- php开发移动app(api)接口时应该注意的事项(仅供参考)
- [转]多操作系统平台协同开发时 GIT 的注意事项: 不同操作系统中的换行符(不要使用git的换行符自动转换功能,并且,尽可能保证代码的换行符都是unix); 避免使用第三方插件(如 EGit );
- 64位平台C/C++开发注意事项
- jsp开发技术应用的29个注意事项
- 64位平台C/C++开发注意事项
- API接口开发的注意事项
- windows 平台开发的JSP程序上传到linux要注意的事项
- 64位平台C/C++开发注意事项