com.feilong.core.lang.thread.AbstractPartitionThreadExecutor Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of feilong Show documentation
feilong is a suite of core and expanded libraries that include utility classes, http, excel,cvs, io classes, and much much more.
There is a newer version: 4.0.8
Show newest version
/*
 * Copyright (C) 2008 feilong
 *
 * 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
 *
 *         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 com.feilong.core.lang.thread;

import static com.feilong.core.date.DateUtil.formatDuration;
import static com.feilong.core.date.DateUtil.now;
import static com.feilong.core.lang.ObjectUtil.defaultIfNullOrEmpty;
import static com.feilong.lib.lang3.ClassUtils.getSimpleName;

import java.util.Date;
import java.util.List;
import java.util.Map;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.feilong.core.Validate;

/**
 * 抽象实现.
 * 
 * 
 * 含公共校验以及日志
 * 
 *
 * @author feilong
 * @since 1.11.0
 */
public abstract class AbstractPartitionThreadExecutor implements PartitionThreadExecutor{

    /** The Constant log. */
    private static final Logger LOGGER = LoggerFactory.getLogger(AbstractPartitionThreadExecutor.class);

    //---------------------------------------------------------------
    /**
     * Excute.
     *
     * @param 
     *            the generic type
     * @param list
     *            the list
     * @param eachSize
     *            the each size
     * @param partitionRunnableBuilder
     *            the partition runnable builder
     */
    @Override
    public  void execute(List list,int eachSize,PartitionRunnableBuilder partitionRunnableBuilder){
        execute(list, eachSize, null, partitionRunnableBuilder);
    }

    //---------------------------------------------------------------

    /**
     * Execute.
     *
     * @param 
     *            the generic type
     * @param list
     *            the list
     * @param eachSize
     *            the each size
     * @param paramsMap
     *            the params map
     * @param partitionRunnableBuilder
     *            the partition runnable builder
     */
    @Override
    public  void execute(List list,int eachSize,Map paramsMap,PartitionRunnableBuilder partitionRunnableBuilder){
        Validate.notEmpty(list, "list can't be null/empty!");
        Validate.notNull(partitionRunnableBuilder, "partitionRunnableBuilder can't be null!");

        Validate.isTrue(eachSize > 0, "eachSize must > 0");

        //---------------------------------------------------------------
        String partitionRunnableBuilderName = getName(partitionRunnableBuilder);
        if (LOGGER.isInfoEnabled()){
            LOGGER.info("begin [{}],list size:[{}],eachSize:[{}]", partitionRunnableBuilderName, list.size(), eachSize);
        }

        //---------------------------------------------------------------
        Date beginDate = now();

        actualExecute(list, eachSize, paramsMap, partitionRunnableBuilder);

        //---------------------------------------------------------------
        if (LOGGER.isInfoEnabled()){
            LOGGER.info("end [{}],use time:[{}]", partitionRunnableBuilderName, formatDuration(beginDate));
        }
    }

    //---------------------------------------------------------------

    /**
     * 让实现类 focus 实现具体代码流程, 已经校验完参数.
     * 
     * @param 
     *            the generic type
     * @param list
     *            执行解析的list
     *            
     *            比如 100000个 User
     *            
     * @param eachSize
     *            每个线程执行多少个对象
     *            
     *            比如 一个线程解析 1000个 User, 那么程序内部 会自动创建 100000/1000个 线程去解析;
     *            
     * @param paramsMap
     *            自定义的相关参数
     *            
     *            自定义的 partitionRunnableBuilder中使用,可能为null
     *            
     * @param partitionRunnableBuilder
     *            每个线程做的事情
     * @since 2.0.0 change name from actualExcute to actualExecute
     */
    protected abstract  void actualExecute(
                    List list,
                    int eachSize,
                    Map paramsMap,
                    PartitionRunnableBuilder partitionRunnableBuilder);

    //---------------------------------------------------------------

    /**
     * Gets the name.
     *
     * @param 
     *            the generic type
     * @param partitionRunnableBuilder
     *            the partition runnable builder
     * @return the name
     */
    protected static  String getName(PartitionRunnableBuilder partitionRunnableBuilder){
        return defaultIfNullOrEmpty(getSimpleName(partitionRunnableBuilder.getClass()), partitionRunnableBuilder.getClass().getName());
    }
}