亚洲午夜av影院,91亚洲导航深夜福利,亚洲乱码日产一区三区

Tommy Jian — Fri, 29 Jun 2007 05:35:00 GMT

使用标注�q�行配置

标注现在已经很流行了�Q�许多�h选择它作为XML的替代来�q�行元数据编�E�。标注中不应该包含配�|�信息，而iBATIS通过XML来进行的工作也不光是配置�?/p>

那么什么是配置�Q�什么又不是呢？目前�Q�iBATIS的XML文�g包含了三斚w��Q?/p>

配置信息
元数据信�?/li>
代码

当�?zh��n)�把环境设�|�改变后�Q��?zh��n)�同时也需要更攚w��|�，例如数据库连接配�|�、事务管理配�|�等�{�。当�(zh��n)�将应用分发��C��同的数据库，而且也��用了一些专有的SQL语句后，配置中可能还要包含SQL方言的一些配�|�信息。在iBATIS 3.0中我们可以将�q�些信息包含�q�去�Q�因此，�(zh��n)�需要针对多�U�方�a��q�行�~�码�Q�当然这是手工的�Q�，为它们命名，�q�将它们配置到适当的位�|�。配�|�信息不应该被包含在Java源文件中�?/p>

元数据信息包括诸如结果映��、参数映��和�~�存模型之类的信息。这些信息控制iBATIS如何映射�(zh��n)�的数据以及(qi��ng)�q�些映射的具体表现�?/p>

�~�码包括SQL以及(qi��ng)动态的SQL语句�?/p>

那么标注应该承担什么样的职责呢�Q?/p>

一般情况下�Q�只有元数据信息比较适合使用标注来描�q�。配�|�应该通过属性文件或者XML文�g来实现。编码也只能通过Java文�g或者XML文�g来实现。更�q�一步看�Q�标注只能用来描�q�相对较��单的元数据信息。有�Ӟ��标注�Q�特别是在Java中）也会(x��)使事情变得更加复杂，使代码更加晦涩难懂�?/p>

因�ؓ(f��)上面的原因，所以我推荐只将标注作�ؓ(f��)�U�定配置的替代配�|�。这��是��_(d��)��使用�q�种配置方式可以辑ֈ�一定的效果�Q�但是也仅仅限于此�?/p>

再一�ơ强调，C#的Attribute在某些方面要��Z��Java的标注：(x��)

支持多行字符�Ԍ��q��得内嵌SQL�~�码令�h感到愉快
支持使用同一标注多次�Q�而在Java中则需要通过集合标注来实�?/li>
支持��序和命名参敎ͼ��q��得代码变得更加简明扼�?/li>

下面�q�个例子展示了如何��用Java中的标注来完成配�|�：(x��)

//
// Simple select, string concatenation, inline results(!) and inline parameters
//
@Select("SELECT #id(EMP_ID:NUMERIC), #firstName(FIRST_NAME:VARCHAR), #lastName(LAST_NAME:VARCHAR) " +
"FROM EMPLOYEE")
List selectAllEmployees();
//
// Alternative syntax using an array of strings instead of string concatenation...can be "smarter" than concatenation
//
@Select({"SELECT #id(EMP_ID:NUMERIC), #firstName(FIRST_NAME:VARCHAR), #lastName(LAST_NAME:VARCHAR) ",
"FROM EMPLOYEE",
"WHERE EMP_ID = @id"})
Employee selectEmployee(int id);
//
// Inserts look as you might expect. We can use getGeneratedKeys to get autogen key values, selectkey still supported
//
@Insert({"INSERT INTO EMPLOYEE (EMP_ID, FIRST_NAME, LAST_NAME)",
"VALUES (@id, @firstName, @lastName)"})
void insertEmployee(Employee emp);
//
// Nothing special about update
//
@Update({"UPDATE EMPLOYEE SET",
"EMP_ID=@id(NUMERIC:IN), FIRST_NAME=@firstName(VARCHAR:IN), LAST_NAME=@lastName(VARCHAR:IN)"})
void updateEmployee(Employee emp);
//
// Delete is obvious.
//
@Delete("DELETE EMPLOYEE WHERE EMP_ID = @id")
void deleteEmployee(int id);

下面�q�个例子要更加复杂一些，像这�U��用了如此多的标注的情况就应该考虑使用XML文�g来进行配�|�。这�U�情况下�Q�我惌��标注能够提供一切功能，即XML中实现的功能通过标注也能完成。然而，我们�q�是��(zh��n)�在面对复杂的情冉|��使用XML来进行配�|�。或许某些�h不是特别在意使用XML配置�Q�所以我们�ؓ(f��)他们提供了标注配�|�方式�?/p>

//
// complex stuff
//
@ResultClass (Company.class)
@ConstructorResults({
@Result(property="id", column="C.COMP_ID"),
@Result(property="name", column="C.NAME")
})
@PropertyResults({
@Result(property="departments.id", column="D.DEPT_ID"),
@Result(property="departments.name", column="D.NAME"),
@Result(property="departments.employee.id", column="E.EMP_ID"),
@Result(property="departments.employee.firstName", column="E.FIRST_NAME"),
@Result(property="departments.employee.lastName", column="E.LAST_NAME")
})
@Collections ({
@Collection(type=Department.class, property="departments", groupBy="id"),
@Collection(type=Employee.class, property="departments.employees", groupBy="departments.id")
})
@Select("SELECT #id, #name, " +
"#departments.id, #departments.name, " +
"#departments.employees.id, #departments.employees.firstName, " +
"#departments.employees.lastName " +
"FROM COMPANY C, DEPARTMENT D, EMPLOYEE E " +
"WHERE D.DEPT_ID = E.DEPT_ID " +
"AND C.COMP_ID = D.COMP_ID")
List selectAllCompaniesWithJoin();
/*
* NESTED QUERIES
*/
@ResultClass (Company.class)
@FieldResults({
@Result(property="id", column="COMP_ID"),
@Result(property="name", column="NAME")
})
@PropertyResults({
@Result(property="departments",
nestedQuery=@QueryMethod(type=CompanyMapper.class, methodName="getDepartmentsForCompany", parameters="id"))
})
@Select("SELECT #id, #name FROM COMPANY C ")
List selectAllCompaniesWithNestedQueries();
@ResultClass (Department.class)
@PropertyResults({
@Result(property="id", column="DEPT_ID"),
@Result(property="name", column="NAME"),
@Result(property="employees",
nestedQuery=@QueryMethod(type=CompanyMapper.class, methodName="getEmployeesForDeparment", parameters="id"))
})
@Select("SELECT #id, #name FROM DEPARTMENT WHERE COMP_ID = @id ")
List getDepartmentsForCompany(int id);
@ResultClass (Employee.class)
@PropertyResults({
@Result(property="id", column="EMP_ID"),
@Result(property="firstName", column="FIRST_NAME"),
@Result(property="lastName", column="LAST_NAME")
})
@Select("SELECT #id, #firstName, #lastName FROM EMPLOYEE WHERE EMP_ID = @id ")
List getEmployeesForDepartment(int id);

Tommy Jian 2007-06-29 13:35 发表评论

��译�Q�iBATIS 3.0 草案——约定俗成的配置方式

Tommy Jian — Tue, 26 Jun 2007 01:47:00 GMT

�U�定俗成

Clinton��_(d��)��(x��)�q�一�Ҏ(gu��)��与我们以前所坚持的原则不相符合的。认识我的�h都知道我基本上算是一个完��的人。但是如果我们从最�?j��ng)_��늚�角度去考虑�Q�我们必��d��解决复杂问题的时候也使用��量��单的解决�Ҏ(gu��)��。当�Ӟ��那些不太喜欢�U�定俗成式配�|�的人可以忽略这�U�配�|�方式。但是我�怿��q�是非常有用的，特别是对插入、删除和更新操作来说。��用这�U�配�|�方式，一些简单的查询也将从中受益�?/p>

默认情况下，iBATIS 3.0��用约定俗成式的配�|�方式。Java 5的方法语义中已经包含了生成SQL、进行参数和�l�果映射��_��的信息。例如：(x��)

Employee getEmployee (int id);

�q�些信息对于生成以下SQL已经��_��了：(x��)

SELECT id, firstName, lastName FROM Employee WHERE id = ?

�l�果�c�d��与方法的�q�回值类型是一致的。因为方法的�q�回值类型不是集合类型，所以我们知道正在处�?#8220;Select One”语义。表的名�U�被假定��Z��l�果�c�d��的名�U�C��致。而查询参数就被假定�ؓ(f��)�Ҏ(gu��)��对应的参数。在使用其他的配�|�方式的时候，我们可以更改默认ID参数的配�|�。SQL语句中的各数据列假定与方法返回类型的同名属性一一对应�Q�当然这些配�|�都是可以更改的�?/p>

集合�c�d��也是以同��L(f��ng)��方式工作�Q?/p>

List listAllEmployees ();

�q�个例子��生以下SQL语句�Q?/p>

SELECT id, firstName, lastName FROM Employee

我们可以��这个例子叫�?#8220;Select Many”�Q�因��个方法返回了一个集合类型。我们知道Where子句为空�Q�因��个方法没有�Q何参数�?/p>

如果我们想��用参数式查询�Q�我们可以这��h��做：(x��)

List findEmployeesLike(Employee employee);

假设只有参数的lastName�Q�而其他引用类型都为null��|��原始�c�d��都被讄��为非法无意义的��|��比如-1�Q�，我们��得��C��下的SQL语句�Q?/p>

SELECT id, firstName, lastName FROM Employee WHERE lastName = 'Begin'

或者可以直接按参数来进行：(x��)

List findEmployeeByLastNameAndFirstName (String last, String first);

�q�将生成以下的SQL语句�Q?/p>

SELECT id, firstName, lastName FROM Employee WHERE lastName = 'Begin' AND firstName = 'Clinton'

因�ؓ(f��)C#支持参数名称的反��，所以C#对这�U�方法提供了更好的支持。�Ş式上也变得相�Ҏ(gu��)��晎ͼ�当然实质是一��L(f��ng)��Q?/p>

// C#
IList FindEmployeesLike(string lastName, string firstName);
// And in C# 3.0, we can use anonymous types:
IList FindEmployeesLike(object obj);
//...
IList employees = mapper.FindEmployeesLike(new {LastName="Begin", FirstName="Clinton"});

更新操作也以相同的方式操作：(x��)

void insertEmployee (Employee emp);
void updateEmployee (Employee emp);
void deleteEmployee (Employee emp);

也可以自动接受集合参敎ͼ�(x��)

int insertEmployee (List emps); // returns rows inserted
int updateEmployee (List emps); // returns rows updated
int deleteEmployee (List emps); // returns rows deleted

生成器相当的灉|��Q�而且可以为大多数删除甚至更新操作生成一条SQL语句�?/p>

Tommy Jian 2007-06-26 09:47 发表评论

Tommy Jian — Fri, 22 Jun 2007 03:23:00 GMT

多种配置方式

iBATIS中最古老的��是光��|�方式。在��目开始的时候，XML被认为最好的配置方式。事实上�Q�XML现在�q�是比较好的配置�Ҏ(gu��)��Q�因为它是进行复杂的多行SQL配置的最��x��式。因此，XML的配�|�方式将予以保留。但是它不再是默认的配置方式�Q�而且也不见得是大多数应用的首选�?/p>

iBATIS 3.0��用多�U�配�|�方式。这��是说iBATIS��可以��用多�U�方式进行配�|�，而且�q�些方式可以协同工作。按照实用性排序，有以下四�U�方法：(x��)

�U�定俗成
Java的标识（可以覆盖前一�U�配�|�的配置信息�Q?/li>
XML�Q�可以覆盖前两种配置的配�|�信息）
Java API�Q�可以覆盖以上配�|�的配置信息�Q?/li>

Tommy Jian 2007-06-22 11:23 发表评论

��译�Q�iBATIS 3.0 草案——事务、会(x��)话和工厂�c�Z��—MapperFactory

Tommy Jian — Wed, 20 Jun 2007 08:00:00 GMT

事务、会(x��)话和工厂�c�Z��—MapperFactory

我们应该在何处获�?#8220;Mapper”的实例呢�Q�我们仍焉��要一个核心类来完成iBATIS的配�|�和控制。这个核心类的名�U�尚在争��Z��中，但是我们不妨先叫它MapperFactory�?/p>

通常情况下，MapperFactory负责构徏事务和映��类的实例。而MapperFactory本��n��由某个配置�c�L��构徏�?/p>

MapperFactory factory = someConfiguration.buildMapperFactory();
EmployeeMapper employeeMapper = factory.getMapper (EmployeeMapper.class);

对于�q�种方式是不是会(x��)使事情变得简�?..或许�?x��)吧�Q�至于事务，Clinton是这栯��的：(x��)“�?x��)话的概念应该和事务的进行合�q�。在iBATIS中，�?x��)话和事务很多时候是一致甚��x��一��L(f��ng)��。但是它们因��Z��些�h为的架构斚w��的原因而被分开了。会(x��)话或许能够完成不��Q务，但是其中�?0%�q�不适合用会(x��)话来解决。同��L(f��ng)��Q�批处理操作也从事务中分��d��来，因�ؓ(f��)事务在提供批处理功能是往往�?x��)导致��o(h��)人生厌的try/finally的多重嵌套。因此在我们发现真实的需求之前应该尽量避免这些�?#8221;�?/p>

iBATIS或者其他第三方库及(qi��ng)容器都可以进行事务处理。目前，事务的处理是由SqlMapClient实例中的ThreadLocal实例来处理的。因��U�处理方法，我们配到了不��问题。不是出于技术的原因而是因�ؓ(f��)代码更加清晰�Q�我们可以��用以下的�Ҏ(gu��)��Q?/p>

Transaction tx = factory.startTransaction();
try 
{
  // do work
  tx.commit();
}
 finally
 {
  tx.end();
}

批处理操作可以简单地通过启动支持批处理操作的事务来进行：(x��)

Transaction tx = factory.startBatch();
try 
{
  // do work
  // balk executes current batch immediately, returns total rows updated
  // (balks on non-batched transactions)
  int totalRowCount = tx.flush();
  // commit executes batch too, returns total rows updated and commits
  totalRowCount = tx.commit();
} 
finally
 {
  tx.end();
}

与现在的事务的API�c�M��Q�我们对事务的隔��ȝ�别以�?qi��ng)其他选项提供支持�?/p>

Transaction tx = factory.startTransaction(isolationLevel);
try 
{
  // do work
  tx.commit();
}
 finally
 {
  tx.end();
}

如果�W�三方的库提供了事务处理的支持，那么受托��理的连接对象可以作为参��C��入：(x��)

// Can be handled by encapsulating framework (e.g. Spring)
Transaction tx = factory.useConnection(conn);
try
 {
  //...do work...
  tx.flush(); // executes batched updates immediately
  // commit simply calls commit on the connection
  // if local commits are allowed, otherwise it is ignored.
  tx.commit();
}
 finally
 {
  tx.end(); // Can also be handled by encapsulating framework (e.g. Spring)
}

��M��Q�这��L(f��ng)��API十分的简�z�，而且易于与诸如Spring�q�样的第三方框架集成。MapperFactory可以被注入到需要事务管理、批处理和隔��ȝ�别的Spring的DAO对象中。�ؓ(f��)了进一步进行必要的分离�Q�我们可以将事务��理功能从MapperFactory中分��d��来，甚至于允许开发者定义自��q��事务��理接口�Q�同时将事务��理的功能绑定到�c�M��Q�这��h��供了更加松耦合的架构）�?/p>

Tommy Jian 2007-06-20 16:00 发表评论

Tommy Jian — Tue, 19 Jun 2007 09:40:00 GMT

接口�l�定

随着Java 5的推�q�，我们有机�?x��)来改善用户体验。其中最重要的是借助Java 5可以消除令�h生惑的类型�{换，可以消除SQL映射��Z��字符的调用方式。�D例来��_(d��)��现在在调用SQL映射的时候是�q�样的：(x��)

Employee employee = (Employee)sqlMapper.queryForList("getEmployee", 5);
//...and...
List employees = sqlMapper.queryForList("listAllEmployees");

问题是很明显的。第一�Q�上面的两个例子中被映射的语句的名称都是��Z��字符串的�Q�而这很容易导致错误。这�U�方式也不会(x��)得到IDE工具、编译器的支持和��理�?/p>

�W�二个问题是存在参数和返回值类型安全问题。在�W�一个例子中�Q�谁能保证参数的�c�d��一定是Integer�Q�而谁又能保证�(zh��n)�得到的�q�回��g��定是Employee�c�d��呢？�q�里�Q�编译器也不�?x��)给��Z�Q何偿错误报告和提�C�。而只有运行时异常�?x��)被抛出�?/p>

最后，在集合的例子中问题也是相同的。在�q�行前，�(zh��n)�可能会(x��)获得Dogs的集合，而不是Employees�?/p>

��M��Q�这�U�方式虽然比JDBC强，但是也让人倍感隑֏��Q�还是存在改善的�I�间�?/p>

在Java 5中我们可以充分��用范型来规范集合�c�d��。这��P��我们不需要进行特�D�的配置��可以�ؓ(f��)集合�c�d��建立一致的API。我们不需要在XML文�g中声明类型，不需要通过字符名称来调用被映射的语句，相反�Q�我们可以充分利用表辑֥�且类型安全的接口�c�d��。没有什么新东西需要学�?f��n)，只是普通的接口��可以了�?/p>

public interface EmployeeMapper 
{  
  Employee getEmployee (int employeeId);  
  List listAllEmployees();
}

�q�就够了�Q�iBATIS来帮我们实现�q�个接口�?/p>

现在我们可以以一�U�更加简�z�和安全的方式来调用被映��的语句了�?/p>

Employee emp = empMapper.getEmployee(5);
//...and...
List employees = empMapper.listAllEmployees();

在上面的调用中没有类型�{换、没有字�W�串�Q�而且参数和返回值的�c�d��是、安全的。额外的代码��是针对接口使用XML或者Java的标识进行配�|�。最多我们只需要配�|�SQL语句、需要进行重载的参数或者返回值类型�?/p>

接口描述了所需要的一切�?/p>

语句的名�U�ͼ�默认情况下与�Ҏ(gu��)��的名字一��_(d��)��
参数�c�d��Q�如果存在的话）
�q�回值类型（包括范型集合的元素的�c�d��Q?/li>

而其中最有趣的就是我们可以基于方法名�U�这��L(f��ng)��U�定来生成SQL映射。以后关于配�|�的章节中将详细讨论�q�些�l�节�?/p>

接口�l�定的方法��得诸如Spring�q�样的框架将映射�c�L��入其他类变得�Ҏ(gu��)��Q�同时也不需要将事务��理的过多细节公开�?/p>

Tommy Jian 2007-06-19 17:40 发表评论

亚洲午夜av影院,91亚洲导航深夜福利,亚洲乱码日产一区三区

���译�Q�iBATIS 3.0 草案——约定俗成的配置方式

���译�Q�iBATIS 3.0 草案——事务、会(x��)话和工厂�c�Z��—MapperFactory

��译�Q�iBATIS 3.0 草案——约定俗成的配置方式

��译�Q�iBATIS 3.0 草案——事务、会(x��)话和工厂�c�Z��—MapperFactory