org.jfaster.mango.descriptor.MethodDescriptor Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of mango Show documentation
mango is a dao framework.
The newest version!
/*
 * Copyright 2014 mango.jfaster.org
 *
 * The Mango Project licenses this file to you 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:
 *
 *   http://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.jfaster.mango.descriptor;

import org.jfaster.mango.annotation.*;
import org.jfaster.mango.exception.DescriptionException;
import org.jfaster.mango.util.Strings;
import org.jfaster.mango.util.ToStringHelper;
import org.jfaster.mango.util.logging.InternalLogger;
import org.jfaster.mango.util.logging.InternalLoggerFactory;
import org.jfaster.mango.util.reflect.Reflection;

import javax.annotation.Nullable;
import java.lang.annotation.Annotation;
import java.lang.reflect.Type;
import java.util.Collections;
import java.util.List;

/**
 * 方法描述
 *
 * @author ash
 */
public class MethodDescriptor {

  private final static InternalLogger logger = InternalLoggerFactory.getInstance(MethodDescriptor.class);

  private final String name;
  private final Class daoClass;
  private final ReturnDescriptor returnDescriptor;
  private final List parameterDescriptors;

  private String cachedSQL;

  private MethodDescriptor(
      String name, Class daoClass, ReturnDescriptor returnDescriptor,
      List parameterDescriptors) {
    this.name = name;
    this.daoClass = daoClass;
    this.returnDescriptor = returnDescriptor;
    this.parameterDescriptors = Collections.unmodifiableList(parameterDescriptors);
  }

  public static MethodDescriptor create(
      String name, Class daoClass, ReturnDescriptor returnDescriptor,
      List parameterDescriptors) {
    return new MethodDescriptor(name, daoClass, returnDescriptor, parameterDescriptors);
  }

  public String getName() {
    return name;
  }

  public Class getDaoClass() {
    return daoClass;
  }

  public boolean isAnnotationPresent(Class annotationType) {
    return getAnnotation(annotationType) != null;
  }

  @Nullable
  public  A getAnnotation(Class annotationType) {
    return returnDescriptor.getAnnotation(annotationType);
  }

  public   List getAnnotations(Class annotationType) {
    return returnDescriptor.getAnnotations(annotationType);
  }

  public Type getReturnType() {
    return returnDescriptor.getType();
  }

  public Class getReturnRawType() {
    return returnDescriptor.getRawType();
  }

  public List getAnnotations() {
    return returnDescriptor.getAnnotations();
  }

  public ReturnDescriptor getReturnDescriptor() {
    return returnDescriptor;
  }

  public List getParameterDescriptors() {
    return parameterDescriptors;
  }

  public String getSQL() {
    if (cachedSQL != null) {
      return cachedSQL;
    }
    SQL sqlAnno = getAnnotation(SQL.class);
    String sql = null;
    if (sqlAnno != null) {
      sql = sqlAnno.value();
    } else {
      List useSqlGeneratorAnnos = getAnnotations(UseSqlGenerator.class);
      if (useSqlGeneratorAnnos.isEmpty()) {
        throw new DescriptionException("each method expected one of @SQL or @UseSqlGenerator annotation but not found");
      }
      for (UseSqlGenerator useSqlGeneratorAnno : useSqlGeneratorAnnos) {
        SqlGenerator sqlGenerator = Reflection.instantiateClass(useSqlGeneratorAnno.value());
        sql = sqlGenerator.generateSql(this);
        if (Strings.isNotEmpty(sql)) {
          break;
        }
      }
    }
    if (Strings.isEmpty(sql)) {
      throw new DescriptionException("sql is null or empty");
    }
    if (logger.isDebugEnabled()) {
      logger.info("SQL of {} is '{}'", ToStringHelper.toString(this), sql);
    }
    cachedSQL = sql;
    return cachedSQL;
  }

  @Nullable
  public String getGlobalTable() {
    DB dbAnno = getAnnotation(DB.class);
    if (dbAnno == null) {
      throw new DescriptionException("dao interface expected one @DB " +
          "annotation but not found");
    }
    String table = null;
    if (Strings.isNotEmpty(dbAnno.table())) {
      table = dbAnno.table();
    }
    return table;
  }

  public String getDataSourceFactoryName() {
    DB dbAnno = getAnnotation(DB.class);
    if (dbAnno == null) {
      throw new DescriptionException("dao interface expected one @DB " +
          "annotation but not found");
    }
    return dbAnno.name();
  }

  @Nullable
  public Sharding getShardingAnno() {
    return getAnnotation(Sharding.class);
  }

  public boolean isReturnGeneratedId() {
    return isAnnotationPresent(ReturnGeneratedId.class) ||
        (name != null && name.contains("ReturnGeneratedId"));
  }

}