001/*
002 *  Copyright (c) 2022-2023, Mybatis-Flex (fuhai999@gmail.com).
003 *  <p>
004 *  Licensed under the Apache License, Version 2.0 (the "License");
005 *  you may not use this file except in compliance with the License.
006 *  You may obtain a copy of the License at
007 *  <p>
008 *  http://www.apache.org/licenses/LICENSE-2.0
009 *  <p>
010 *  Unless required by applicable law or agreed to in writing, software
011 *  distributed under the License is distributed on an "AS IS" BASIS,
012 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 *  See the License for the specific language governing permissions and
014 *  limitations under the License.
015 */
016package com.mybatisflex.annotation;
017
018import java.lang.annotation.*;
019
020/**
021 * 多对一映射。
022 *
023 * @author michael
024 */
025@Inherited
026@Retention(RetentionPolicy.RUNTIME)
027@Target({ElementType.FIELD})
028public @interface RelationManyToOne {
029
030    /**
031     * 当前实体类的属性。
032     *
033     * @return 属性名称
034     */
035    String selfField();
036
037    /**
038     * <p>
039     * 目标实体类对应的表的 schema 模式。
040     *
041     * <p>
042     * 如果目标实体类没有使用 {@code @Table(schema = "...")} 指定 schema 时，
043     * 需要在这里指定对应表的 schema 值。一般关联数据不是 entity 对象，而是 vo、dto
044     * 等需要配置此项。
045     *
046     * @return schema 名称
047     */
048    String targetSchema() default "";
049
050    /**
051     * <p>
052     * 目标实体类对应的表名。
053     *
054     * <p>
055     * 如果目标实体类没有使用 {@code @Table(value = "...")} 指定表名时，
056     * 需要在这里指定对应表的表名。一般关联数据不是 entity 对象，而是 vo、dto
057     * 等需要配置此项。
058     *
059     * @return 表名
060     */
061    String targetTable() default "";
062
063    /**
064     * 目标实体类的关联属性。
065     *
066     * @return 属性名称
067     */
068    String targetField() default "";
069
070    /**
071     * 目标对象的关系实体类的属性绑定
072     * <p>
073     * 当字段不为空串时,只进行某个字段赋值(使用对应字段类型接收)
074     * @return 属性名称
075     */
076    String valueField() default "";
077
078    /**
079     * 中间表名称，一对一的关系是通过通过中间表维护时，需要添加此项配置。
080     *
081     * @return 中间表名称
082     */
083    String joinTable() default "";
084
085    /**
086     * 中间表与当前表的关联字段，一对一的关系是通过通过中间表维护时，需要添加此项配置。
087     *
088     * @return 字段名称，列名
089     */
090    String joinSelfColumn() default "";
091
092    /**
093     * 目标表的关联字段名称，一对一的关系是通过通过中间表维护时，需要添加此项配置。
094     *
095     * @return 字段名称和表
096     */
097    String joinTargetColumn() default "";
098
099    /**
100     * 默认使用哪个数据源，若系统找不到该指定的数据源时，默认使用第一个数据源。
101     *
102     * @return 数据源
103     */
104    String dataSource() default "";
105
106
107    /**
108     * 查询时，追加的额外条件。
109     */
110    String extraCondition() default "";
111
112    /**
113     * 查询（加载）指定的列
114     */
115    String[] selectColumns() default {};
116
117}