4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.logging;
17 |
18 | import org.apache.ibatis.logging.Log;
19 |
20 | import java.util.function.Supplier;
21 |
22 | /**
23 | * Wrapper of {@link Log}, allow log with lambda expressions.
24 | *
25 | * @author Putthiphong Boonphong
26 | */
27 | public class Logger {
28 |
29 | private final Log log;
30 |
31 | Logger(Log log) {
32 | this.log = log;
33 | }
34 |
35 | public void error(Supplier s, Throwable e) {
36 | log.error(s.get(), e);
37 | }
38 |
39 | public void error(Supplier s) {
40 | log.error(s.get());
41 | }
42 |
43 | public void warn(Supplier s) {
44 | log.warn(s.get());
45 | }
46 |
47 | public void debug(Supplier s) {
48 | if (log.isDebugEnabled()) {
49 | log.debug(s.get());
50 | }
51 | }
52 |
53 | public void trace(Supplier s) {
54 | if (log.isTraceEnabled()) {
55 | log.trace(s.get());
56 | }
57 | }
58 |
59 | }
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/logging/LoggerFactory.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.logging;
17 |
18 | import org.apache.ibatis.logging.LogFactory;
19 |
20 | /**
21 | * LoggerFactory is a wrapper around {@link LogFactory} to support {@link Logger}.
22 | *
23 | * @author Putthiphong Boonphong
24 | */
25 | public class LoggerFactory {
26 |
27 | public static Logger getLogger(Class aClass) {
28 | return new Logger(LogFactory.getLog(aClass));
29 | }
30 |
31 | public static Logger getLogger(String logger) {
32 | return new Logger(LogFactory.getLog(logger));
33 | }
34 |
35 | }
36 |
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/MyBatisExceptionTranslator.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring;
17 |
18 | import org.apache.ibatis.exceptions.PersistenceException;
19 | import org.springframework.dao.DataAccessException;
20 | import org.springframework.dao.support.PersistenceExceptionTranslator;
21 | import org.springframework.jdbc.support.SQLErrorCodeSQLExceptionTranslator;
22 | import org.springframework.jdbc.support.SQLExceptionTranslator;
23 | import org.springframework.transaction.TransactionException;
24 |
25 | import javax.sql.DataSource;
26 | import java.sql.SQLException;
27 |
28 | /**
29 | * Default exception translator.
30 | *
31 | * Translates MyBatis SqlSession returned exception into a Spring
32 | * {@code DataAccessException} using Spring's {@code SQLExceptionTranslator}
33 | * Can load {@code SQLExceptionTranslator} eagerly or when the
34 | * first exception is translated.
35 | *
36 | * @author Eduardo Macarron
37 | */
38 | public class MyBatisExceptionTranslator implements PersistenceExceptionTranslator {
39 |
40 | private final DataSource dataSource;
41 |
42 | private SQLExceptionTranslator exceptionTranslator;
43 |
44 | /**
45 | * Creates a new {@code DataAccessExceptionTranslator} instance.
46 | *
47 | * @param dataSource DataSource to use to find metadata and establish which error codes are usable.
48 | * @param exceptionTranslatorLazyInit if true, the translator instantiates internal stuff only the first time will
49 | * have the need to translate exceptions.
50 | */
51 | public MyBatisExceptionTranslator(DataSource dataSource, boolean exceptionTranslatorLazyInit) {
52 | this.dataSource = dataSource;
53 |
54 | if (!exceptionTranslatorLazyInit) {
55 | this.initExceptionTranslator();
56 | }
57 | }
58 |
59 | /**
60 | * {@inheritDoc}
61 | */
62 | @Override
63 | public DataAccessException translateExceptionIfPossible(RuntimeException e) {
64 | if (e instanceof PersistenceException) {
65 | // Batch exceptions come inside another PersistenceException
66 | // recursion has a risk of infinite loop so better make another if
67 | if (e.getCause() instanceof PersistenceException) {
68 | e = (PersistenceException) e.getCause();
69 | }
70 | if (e.getCause() instanceof SQLException) {
71 | this.initExceptionTranslator();
72 | return this.exceptionTranslator.translate(e.getMessage() + "\n", null, (SQLException) e.getCause());
73 | } else if (e.getCause() instanceof TransactionException) {
74 | throw (TransactionException) e.getCause();
75 | }
76 | return new MyBatisSystemException(e);
77 | }
78 | return null;
79 | }
80 |
81 | /**
82 | * Initializes the internal translator reference.
83 | */
84 | private synchronized void initExceptionTranslator() {
85 | if (this.exceptionTranslator == null) {
86 | this.exceptionTranslator = new SQLErrorCodeSQLExceptionTranslator(this.dataSource);
87 | }
88 | }
89 |
90 | }
91 |
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/MyBatisSystemException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring;
17 |
18 | import org.springframework.dao.UncategorizedDataAccessException;
19 |
20 | /**
21 | * MyBatis specific subclass of {@code UncategorizedDataAccessException}, for MyBatis system errors that do
22 | * not match any concrete {@code org.springframework.dao} exceptions.
23 | *
24 | * In MyBatis 3 {@code org.apache.ibatis.exceptions.PersistenceException} is a {@code RuntimeException},
25 | * but using this wrapper class to bring everything under a single hierarchy will be easier for client code to
26 | * handle.
27 | *
28 | * MyBatis 自定义的系统异常
29 | *
30 | * @author Hunter Presnall
31 | */
32 | public class MyBatisSystemException extends UncategorizedDataAccessException {
33 |
34 | private static final long serialVersionUID = -5284728621670758939L;
35 |
36 | public MyBatisSystemException(Throwable cause) {
37 | super(null, cause);
38 | }
39 |
40 | }
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/SqlSessionHolder.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2018 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring;
17 |
18 | import org.apache.ibatis.session.ExecutorType;
19 | import org.apache.ibatis.session.SqlSession;
20 | import org.springframework.dao.support.PersistenceExceptionTranslator;
21 | import org.springframework.transaction.support.ResourceHolderSupport;
22 |
23 | import static org.springframework.util.Assert.notNull;
24 |
25 | /**
26 | * Used to keep current {@code SqlSession} in {@code TransactionSynchronizationManager}.
27 | *
28 | * The {@code SqlSessionFactory} that created that {@code SqlSession} is used as a key.
29 | * {@code ExecutorType} is also kept to be able to check if the user is trying to change it
30 | * during a TX (that is not allowed) and throw a Exception in that case.
31 | *
32 | * SqlSession 持有器，用于保存当前 SqlSession 对象，保存到 TransactionSynchronizationManager 中
33 | *
34 | * @author Hunter Presnall
35 | * @author Eduardo Macarron
36 | */
37 | public final class SqlSessionHolder extends ResourceHolderSupport {
38 |
39 | /**
40 | * SqlSession 对象
41 | */
42 | private final SqlSession sqlSession;
43 | /**
44 | * 执行器类型
45 | */
46 | private final ExecutorType executorType;
47 | /**
48 | * PersistenceExceptionTranslator 对象
49 | */
50 | private final PersistenceExceptionTranslator exceptionTranslator;
51 |
52 | /**
53 | * Creates a new holder instance.
54 | *
55 | * @param sqlSession the {@code SqlSession} has to be hold.
56 | * @param executorType the {@code ExecutorType} has to be hold.
57 | * @param exceptionTranslator the {@code PersistenceExceptionTranslator} has to be hold.
58 | */
59 | public SqlSessionHolder(SqlSession sqlSession,
60 | ExecutorType executorType,
61 | PersistenceExceptionTranslator exceptionTranslator) {
62 | notNull(sqlSession, "SqlSession must not be null");
63 | notNull(executorType, "ExecutorType must not be null");
64 |
65 | this.sqlSession = sqlSession;
66 | this.executorType = executorType;
67 | this.exceptionTranslator = exceptionTranslator;
68 | }
69 |
70 | public SqlSession getSqlSession() {
71 | return sqlSession;
72 | }
73 |
74 | public ExecutorType getExecutorType() {
75 | return executorType;
76 | }
77 |
78 | public PersistenceExceptionTranslator getPersistenceExceptionTranslator() {
79 | return exceptionTranslator;
80 | }
81 |
82 | }
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/annotation/MapperScans.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring.annotation;
17 |
18 | import org.springframework.context.annotation.Import;
19 |
20 | import java.lang.annotation.*;
21 |
22 | /**
23 | * The Container annotation that aggregates several {@link MapperScan} annotations.
24 | *
25 | * 多 @MapperScan 的注解，功能是相同的
26 | *
27 | *
Can be used natively, declaring several nested {@link MapperScan} annotations.
28 | * Can also be used in conjunction with Java 8's support for repeatable annotations,
29 | * where {@link MapperScan} can simply be declared several times on the same method,
30 | * implicitly generating this container annotation.
31 | *
32 | * @author Kazuki Shimizu
33 | * @since 2.0.0
34 | * @see MapperScan
35 | */
36 | @Retention(RetentionPolicy.RUNTIME)
37 | @Target(ElementType.TYPE)
38 | @Documented
39 | @Import(MapperScannerRegistrar.RepeatingRegistrar.class)
40 | public @interface MapperScans {
41 |
42 | /**
43 | * @return @MapperScan 数组
44 | */
45 | MapperScan[] value();
46 |
47 | }
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/annotation/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Contains MyBatis annotations
18 | */
19 | package org.mybatis.spring.annotation;
20 |
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/batch/builder/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Contains classes to builder classes for {@link org.springframework.batch.item.ItemReader} and
18 | * {@link org.springframework.batch.item.ItemWriter}.
19 | *
20 | * @since 2.0.0
21 | */
22 | package org.mybatis.spring.batch.builder;
23 |
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/batch/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Contains classes to facilitate the migration in Spring-Batch applications.
18 | */
19 | package org.mybatis.spring.batch;
20 |
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/config/NamespaceHandler.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring.config;
17 |
18 | import org.springframework.beans.factory.xml.NamespaceHandlerSupport;
19 |
20 | /**
21 | * Namespace handler for the MyBatis namespace.
22 | *
23 | * @author Lishu Luo
24 | *
25 | * @see MapperScannerBeanDefinitionParser
26 | * @since 1.2.0
27 | */
28 | public class NamespaceHandler extends NamespaceHandlerSupport {
29 |
30 | /**
31 | * {@inheritDoc}
32 | */
33 | @Override
34 | public void init() {
35 | registerBeanDefinitionParser("scan", new MapperScannerBeanDefinitionParser());
36 | }
37 |
38 | }
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/config/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Contains the MyBatis namespace schema and element handlers.
18 | */
19 | package org.mybatis.spring.config;
20 |
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/mapper/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Contains classes for automatically building MyBatis mapper proxy classes at
18 | * application startup.
19 | */
20 | package org.mybatis.spring.mapper;
21 |
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Contains core classes to build the MyBatis integration with Spring3.X.
18 | */
19 | package org.mybatis.spring;
20 |
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/support/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Contains Spring3.X support classes for MyBatis.
18 | */
19 | package org.mybatis.spring.support;
20 |
--------------------------------------------------------------------------------
/src/main/java/org/mybatis/spring/transaction/SpringManagedTransactionFactory.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
32 | With MyBatis-Spring, you can continue to directly use the MyBatis API.
33 | Simply create an SqlSessionFactory in Spring using
34 | SqlSessionFactoryBean and use the factory in your code.
35 |
36 |
51 |
52 |
53 | Use this option with care because wrong usage may produce runtime errors or
54 | worse, data integrity problems. Be aware of the following caveats with direct API usage:
55 |
56 |
57 |
58 |
59 | It will not participate in any Spring transactions.
60 |
61 |
62 |
63 |
64 | If the SqlSession is using a DataSource
65 | that is also being used by a Spring transaction manager and there is currently
66 | a transaction in progress, this code will throw an exception.
67 |
68 |
69 |
70 |
71 | MyBatis' DefaultSqlSession is not thread safe. If you
72 | inject it in your beans you will get errors.
73 |
74 |
75 |
76 |
77 | Mappers created using DefaultSqlSession are not thread safe either.
78 | If you inject them it in your beans you will get errors.
79 |
80 |
81 |
82 |
83 | You must make sure that your SqlSessions
84 | are always closed in a finally block.
85 |
MyBatis-Spring 연동 모듈을 사용해도 계속해서 MyBatis API를 직접 사용할 수 있다.
33 | SqlSessionFactoryBean을 사용해서 스프링에서 SqlSessionFactory를 생성하고 팩토리를 사용하면 된다.
34 |
49 |
50 |
이 방법은 신중히 사용하자. 왜냐하면 잘못사용하면 런타임 에러나 데이터 문제등을 야기할수 있기 때문이다.
51 | API를 직접 사용할때는 다음의 규칙들에 유의해야 한다.
52 |
53 |
54 |
스프링 트랜잭션에 속하지 않고 별도의 트랜잭션에서 동작한다.
55 |
56 |
57 |
SqlSession이 스프링 트랜잭션 관리자가 사용하는 DataSource를 사용하고
58 | 이미 트랜잭션이 동작하고 있다면 이 코드는 예외를 발생시킬 것이다.
59 |
60 |
61 |
마이바티스의 DefaultSqlSession은 쓰레드에 안전하지 않다.
62 | 빈에 이 객체를 주입하면 아마도 에러를 발생시킬 수 있다.
63 |
64 |
65 |
DefaultSqlSession을 사용해서 생성한 매퍼 또한 쓰레드에 안전하지 않다.
66 | 이렇게 만든 매퍼를 빈에 주입하면 에러를 발생시킬 수 있다.
67 |
68 |
69 |
SqlSession은 항상 마지막에 close() 메서드를 호출해야 한다.
70 |
71 |
72 |
73 |
74 |
75 |
--------------------------------------------------------------------------------
/src/site/resources/css/site.css:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /*
17 | * when new flags are needed, take them from
18 | *
19 | * http://www.printableworldflags.com/flag-icon
20 | *
21 | * that are free for any kind of usage
22 | */
23 |
24 | ul.i18n {list-style-type:none;}
25 | li.en {background: url('../images/en.png') left no-repeat;padding-left: 32px; margin: 10px}
26 | li.es {background: url('../images/es.png') left no-repeat;padding-left: 32px; margin: 10px}
27 | li.ja {background: url('../images/ja.png') left no-repeat;padding-left: 32px; margin: 10px}
28 | li.zh {background: url('../images/zh.png') left no-repeat;padding-left: 32px; margin: 10px}
29 | li.ko {background: url('../images/ko.png') left no-repeat;padding-left: 32px; margin: 10px}
30 |
--------------------------------------------------------------------------------
/src/site/resources/es/css/site.css:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /*
17 | * when new flags are needed, take them from
18 | *
19 | * http://www.printableworldflags.com/flag-icon
20 | *
21 | * that are free for any kind of usage
22 | */
23 |
24 | ul.i18n {list-style-type:none;}
25 | li.en {background: url('../../images/en.png') left no-repeat;padding-left: 32px; margin: 10px}
26 | li.es {background: url('../../images/es.png') left no-repeat;padding-left: 32px; margin: 10px}
27 | li.ja {background: url('../../images/ja.png') left no-repeat;padding-left: 32px; margin: 10px}
28 | li.zh {background: url('../../images/zh.png') left no-repeat;padding-left: 32px; margin: 10px}
29 | li.ko {background: url('../../images/ko.png') left no-repeat;padding-left: 32px; margin: 10px}
30 |
--------------------------------------------------------------------------------
/src/site/resources/images/en.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/YunaiV/mybatis-spring/47e9afa07b7cb471a586e0f3e50d2ffb6216d56f/src/site/resources/images/en.png
--------------------------------------------------------------------------------
/src/site/resources/images/es.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/YunaiV/mybatis-spring/47e9afa07b7cb471a586e0f3e50d2ffb6216d56f/src/site/resources/images/es.png
--------------------------------------------------------------------------------
/src/site/resources/images/ja.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/YunaiV/mybatis-spring/47e9afa07b7cb471a586e0f3e50d2ffb6216d56f/src/site/resources/images/ja.png
--------------------------------------------------------------------------------
/src/site/resources/images/ko.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/YunaiV/mybatis-spring/47e9afa07b7cb471a586e0f3e50d2ffb6216d56f/src/site/resources/images/ko.png
--------------------------------------------------------------------------------
/src/site/resources/images/zh.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/YunaiV/mybatis-spring/47e9afa07b7cb471a586e0f3e50d2ffb6216d56f/src/site/resources/images/zh.png
--------------------------------------------------------------------------------
/src/site/resources/ja/css/site.css:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /*
17 | * when new flags are needed, take them from
18 | *
19 | * http://www.printableworldflags.com/flag-icon
20 | *
21 | * that are free for any kind of usage
22 | */
23 |
24 | ul.i18n {list-style-type:none;}
25 | li.en {background: url('../../images/en.png') left no-repeat;padding-left: 32px; margin: 10px}
26 | li.es {background: url('../../images/es.png') left no-repeat;padding-left: 32px; margin: 10px}
27 | li.ja {background: url('../../images/ja.png') left no-repeat;padding-left: 32px; margin: 10px}
28 | li.zh {background: url('../../images/zh.png') left no-repeat;padding-left: 32px; margin: 10px}
29 | li.ko {background: url('../../images/ko.png') left no-repeat;padding-left: 32px; margin: 10px}
30 |
--------------------------------------------------------------------------------
/src/site/resources/ko/css/site.css:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /*
17 | * when new flags are needed, take them from
18 | *
19 | * http://www.printableworldflags.com/flag-icon
20 | *
21 | * that are free for any kind of usage
22 | */
23 |
24 | ul.i18n {list-style-type:none;}
25 | li.en {background: url('../../images/en.png') left no-repeat;padding-left: 32px; margin: 10px}
26 | li.es {background: url('../../images/es.png') left no-repeat;padding-left: 32px; margin: 10px}
27 | li.ja {background: url('../../images/ja.png') left no-repeat;padding-left: 32px; margin: 10px}
28 | li.zh {background: url('../../images/zh.png') left no-repeat;padding-left: 32px; margin: 10px}
29 | li.ko {background: url('../../images/ko.png') left no-repeat;padding-left: 32px; margin: 10px}
30 |
--------------------------------------------------------------------------------
/src/site/resources/zh/css/site.css:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /*
17 | * when new flags are needed, take them from
18 | *
19 | * http://www.printableworldflags.com/flag-icon
20 | *
21 | * that are free for any kind of usage
22 | */
23 |
24 | ul.i18n {list-style-type:none;}
25 | li.en {background: url('../../images/en.png') left no-repeat;padding-left: 32px; margin: 10px}
26 | li.es {background: url('../../images/es.png') left no-repeat;padding-left: 32px; margin: 10px}
27 | li.ja {background: url('../../images/ja.png') left no-repeat;padding-left: 32px; margin: 10px}
28 | li.zh {background: url('../../images/zh.png') left no-repeat;padding-left: 32px; margin: 10px}
29 | li.ko {background: url('../../images/ko.png') left no-repeat;padding-left: 32px; margin: 10px}
30 |
--------------------------------------------------------------------------------
/src/site/site.xml:
--------------------------------------------------------------------------------
1 |
2 |
19 |
21 |
22 |
23 |
45 |
46 |
47 |
48 |
--------------------------------------------------------------------------------
/src/site/site_es.xml:
--------------------------------------------------------------------------------
1 |
2 |
19 |
21 |
22 |
23 |
45 |
46 |
47 |
48 |
49 |
--------------------------------------------------------------------------------
/src/site/site_ja.xml:
--------------------------------------------------------------------------------
1 |
2 |
19 |
21 |
22 |
23 |
45 |
46 |
47 |
48 |
49 |
--------------------------------------------------------------------------------
/src/site/site_ko.xml:
--------------------------------------------------------------------------------
1 |
2 |
19 |
21 |
22 |
23 |
45 |
46 |
47 |
48 |
49 |
--------------------------------------------------------------------------------
/src/site/site_zh.xml:
--------------------------------------------------------------------------------
1 |
2 |
19 |
21 |
22 |
23 |
45 |
46 |
47 |
48 |
49 |
--------------------------------------------------------------------------------
/src/site/xdoc/boot.xml:
--------------------------------------------------------------------------------
1 |
2 |
19 |
22 |
23 |
24 | MyBatis-Spring | Spring Boot
25 | Eduardo Macarron
26 |
27 |
28 |
29 |
30 |
32 | With MyBatis-Spring, you can continue to directly use the MyBatis API.
33 | Simply create an SqlSessionFactory in Spring using
34 | SqlSessionFactoryBean and use the factory in your code.
35 |
36 |
51 |
52 |
53 | Use this option with care because wrong usage may produce runtime errors or
54 | worse, data integrity problems. Be aware of the following caveats with direct API usage:
55 |
56 |
57 |
58 |
59 | It will not participate in any Spring transactions.
60 |
61 |
62 |
63 |
64 | If the SqlSession is using a DataSource
65 | that is also being used by a Spring transaction manager and there is currently
66 | a transaction in progress, this code will throw an exception.
67 |
68 |
69 |
70 |
71 | MyBatis' DefaultSqlSession is not thread safe. If you
72 | inject it in your beans you will get errors.
73 |
74 |
75 |
76 |
77 | Mappers created using DefaultSqlSession are not thread safe either.
78 | If you inject them it in your beans you will get errors.
79 |
80 |
81 |
82 |
83 | You must make sure that your SqlSessions
84 | are always closed in a finally block.
85 |
81 |
82 |
83 |
84 |
--------------------------------------------------------------------------------
/src/test/java/org/mybatis/spring/ExecutorInterceptor.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring;
17 |
18 | import java.util.Properties;
19 |
20 | import org.apache.ibatis.executor.Executor;
21 | import org.apache.ibatis.plugin.Interceptor;
22 | import org.apache.ibatis.plugin.Intercepts;
23 | import org.apache.ibatis.plugin.Invocation;
24 | import org.apache.ibatis.plugin.Plugin;
25 | import org.apache.ibatis.plugin.Signature;
26 |
27 | /**
28 | * Keeps track of Executor commits, rollbacks and close status.
29 | *
30 | * The Executor is not accessible from DefaultSqlSession, so it is much easier to use an Interceptor
31 | * rather than subclass a new SqlSessionFactory, etc. Also, there is the potential to change the
32 | * default MyBatis behavior, which could change the test results.
33 | */
34 | @Intercepts({
35 | @Signature(type = Executor.class, method = "commit", args = { boolean.class }),
36 | @Signature(type = Executor.class, method = "rollback", args = { boolean.class }),
37 | @Signature(type = Executor.class, method = "close", args = { boolean.class })
38 | })
39 | final class ExecutorInterceptor implements Interceptor {
40 |
41 | private int commitCount;
42 |
43 | private int rollbackCount;
44 |
45 | private boolean closed;
46 |
47 | @Override
48 | public Object intercept(Invocation invocation) throws Throwable {
49 | if ("commit".equals(invocation.getMethod().getName())) {
50 | ++this.commitCount;
51 | } else if ("rollback".equals(invocation.getMethod().getName())) {
52 | ++this.rollbackCount;
53 | } else if ("close".equals(invocation.getMethod().getName())) {
54 | this.closed = true;
55 | }
56 |
57 | return invocation.proceed();
58 | }
59 |
60 | @Override
61 | public Object plugin(Object target) {
62 | return Plugin.wrap(target, this);
63 | }
64 |
65 | @Override
66 | public void setProperties(Properties properties) {
67 | // do nothing
68 | }
69 |
70 | void reset() {
71 | this.commitCount = 0;
72 | this.rollbackCount = 0;
73 | this.closed = false;
74 | }
75 |
76 | int getCommitCount() {
77 | return this.commitCount;
78 | }
79 |
80 | int getRollbackCount() {
81 | return this.rollbackCount;
82 | }
83 |
84 | boolean isExecutorClosed() {
85 | return this.closed;
86 | }
87 |
88 | }
89 |
--------------------------------------------------------------------------------
/src/test/java/org/mybatis/spring/PooledMockDataSource.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring;
17 |
18 | import java.sql.Connection;
19 | import java.sql.SQLException;
20 | import java.util.LinkedList;
21 |
22 | import com.mockrunner.mock.jdbc.MockDataSource;
23 |
24 | final class PooledMockDataSource extends MockDataSource {
25 |
26 | private int connectionCount = 0;
27 |
28 | private LinkedList connections = new LinkedList<>();
29 |
30 | @Override
31 | public Connection getConnection() throws SQLException {
32 | if (connections.isEmpty()) {
33 | throw new SQLException("Sorry, I ran out of connections");
34 | }
35 | ++this.connectionCount;
36 | return this.connections.removeLast();
37 | }
38 |
39 | int getConnectionCount() {
40 | return this.connectionCount;
41 | }
42 |
43 | void reset() {
44 | this.connectionCount = 0;
45 | this.connections.clear();
46 | }
47 |
48 | @Override
49 | public void setupConnection(Connection connection) {
50 | throw new UnsupportedOperationException("used addConnection() instead");
51 | }
52 |
53 | public void addConnection(Connection c) {
54 | this.connections.add(c);
55 | }
56 |
57 | }
58 |
--------------------------------------------------------------------------------
/src/test/java/org/mybatis/spring/TestMapper.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2016 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring;
17 |
18 | public interface TestMapper {
19 |
20 | int findTest();
21 |
22 | void insertTest(String test);
23 |
24 | }
25 |
--------------------------------------------------------------------------------
/src/test/java/org/mybatis/spring/TestMapper.xml:
--------------------------------------------------------------------------------
1 |
2 |
19 |
22 |
23 |
24 |
27 |
28 | 1
29 |
30 |
31 |
34 |
35 |
36 | INSERT #{test} INTO test
37 |
38 |
39 |
40 | INSERT fail
41 |
42 |
43 |
--------------------------------------------------------------------------------
/src/test/java/org/mybatis/spring/annotation/mapper/ds1/Ds1Mapper.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring.annotation.mapper.ds1;
17 |
18 | public interface Ds1Mapper {
19 | }
20 |
--------------------------------------------------------------------------------
/src/test/java/org/mybatis/spring/annotation/mapper/ds2/Ds2Mapper.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring.annotation.mapper.ds2;
17 |
18 | public interface Ds2Mapper {
19 | }
20 |
--------------------------------------------------------------------------------
/src/test/java/org/mybatis/spring/asyncsynchronization/AsyncAfterCompletionHelper.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2010-2017 the original author or authors.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package org.mybatis.spring.asyncsynchronization;
17 |
18 | import java.lang.reflect.InvocationHandler;
19 | import java.lang.reflect.InvocationTargetException;
20 | import java.lang.reflect.Method;
21 | import java.lang.reflect.Proxy;
22 | import java.util.HashSet;
23 | import java.util.Set;
24 |
25 | import org.springframework.transaction.support.TransactionSynchronization;
26 |
27 | /**
28 | * For use as ByteMan helper
29 | *
30 | * @author Alex Rykov
31 | */
32 | @SuppressWarnings("unused")
33 | public class AsyncAfterCompletionHelper {
34 | /**
35 | *
36 | * Invocation handler that performs afterCompletion on a separate thread
37 | * See Github issue #18
38 | *
39 | * @author Alex Rykov
40 | *
41 | */
42 | static class AsyncAfterCompletionInvocationHandler implements InvocationHandler {
43 |
44 | private Object target;
45 |
46 | AsyncAfterCompletionInvocationHandler(Object target) {
47 | this.target = target;
48 | }
49 |
50 | @Override
51 | public Object invoke(final Object proxy, final Method method,
52 | final Object[] args) throws Throwable {
53 | if ("afterCompletion".equals(method.getName())) {
54 | final Set