All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.ibatis.annotations.SelectProvider Maven / Gradle / Ivy

Go to download

The MyBatis SQL mapper framework makes it easier to use a relational database with object-oriented applications. MyBatis couples objects with stored procedures or SQL statements using a XML descriptor or annotations. Simplicity is the biggest advantage of the MyBatis data mapper over object relational mapping tools.

There is a newer version: 3.5.16
Show newest version
/*
 *    Copyright 2009-2023 the original author or authors.
 *
 *    Licensed under the Apache License, Version 2.0 (the "License");
 *    you may not use this file except in compliance with the License.
 *    You may obtain a copy of the License at
 *
 *       https://www.apache.org/licenses/LICENSE-2.0
 *
 *    Unless required by applicable law or agreed to in writing, software
 *    distributed under the License is distributed on an "AS IS" BASIS,
 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *    See the License for the specific language governing permissions and
 *    limitations under the License.
 */
package org.apache.ibatis.annotations;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Repeatable;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * The annotation that specify a method that provide an SQL for retrieving record(s).
 * 

* How to use: * *

 * public interface UserMapper {
 *
 *   @SelectProvider(type = SqlProvider.class, method = "selectById")
 *   User selectById(int id);
 *
 *   public static class SqlProvider {
 *     public static String selectById() {
 *       return "SELECT id, name FROM users WHERE id = #{id}";
 *     }
 *   }
 *
 * }
 * 
* * @author Clinton Begin */ @Documented @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD) @Repeatable(SelectProvider.List.class) public @interface SelectProvider { /** * Specify a type that implements an SQL provider method. * * @return a type that implements an SQL provider method * * @since 3.5.2 * * @see #type() */ Class value() default void.class; /** * Specify a type that implements an SQL provider method. *

* This attribute is alias of {@link #value()}. * * @return a type that implements an SQL provider method * * @see #value() */ Class type() default void.class; // @formatter:off /** * Specify a method for providing an SQL. *

* Since 3.5.1, this attribute can omit. *

* If this attribute omit, the MyBatis will call a method that decide by following rules. * *

    *
  • * If class that specified the {@link #type()} attribute implements the * {@link org.apache.ibatis.builder.annotation.ProviderMethodResolver}, * the MyBatis use a method that returned by it. *
  • *
  • * If cannot resolve a method by {@link org.apache.ibatis.builder.annotation.ProviderMethodResolver} * (= not implement it or it was returned null, * the MyBatis will search and use a fallback method that named provideSql from * specified type. *
  • *
* * @return a method name of method for providing an SQL */ // @formatter:on String method() default ""; /** * @return A database id that correspond this provider * * @since 3.5.5 */ String databaseId() default ""; /** * Returns whether this select affects DB data.
* e.g. RETURNING of PostgreSQL or OUTPUT of MS SQL Server. * * @return {@code true} if this select affects DB data; {@code false} if otherwise * * @since 3.5.12 */ boolean affectData() default false; /** * The container annotation for {@link SelectProvider}. * * @author Kazuki Shimizu * * @since 3.5.5 */ @Documented @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD) @interface List { SelectProvider[] value(); } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy