com.feilong.taglib.display.httpconcat.handler.ItemSrcListResolver 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.taglib.display.httpconcat.handler;

import static com.feilong.core.Validator.isNullOrEmpty;
import static com.feilong.core.lang.StringUtil.LF;
import static com.feilong.core.util.CollectionsUtil.removeDuplicate;
import static java.util.Collections.emptyList;

import java.util.ArrayList;
import java.util.List;

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

import com.feilong.core.Validate;
import com.feilong.core.lang.StringUtil;

/**
 * 专门用来提取标签体内容的.
 *
 * @author feilong
 * @since 1.10.4
 */
public final class ItemSrcListResolver{

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

    /** Don't let anyone instantiate this class. */
    private ItemSrcListResolver(){
        //AssertionError不是必须的. 但它可以避免不小心在类的内部调用构造器. 保证该类在任何情况下都不会被实例化.
        //see 《Effective Java》 2nd
        throw new AssertionError("No " + getClass().getName() + " instances for you!");
    }

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

    /**
     * Resolve.
     *
     * @param blockContent
     *            内容,目前 以 \n 分隔
     * @param domain
     *            the domain
     * @return 如果 blockContent 是null,抛出 {@link NullPointerException}

     *         如果 blockContent 是blank,抛出 {@link IllegalArgumentException}

     *         使用换行符,转成字符串数组,如果 数组 是null或者是empty,抛出 {@link IllegalArgumentException}

     * @since 1.11.1 remove type param
     */
    public static List resolve(String blockContent,String domain){
        Validate.notBlank(blockContent, "blockContent can't be blank!");

        //---------------------------------------------------------------
        //可能有内容, 数组不是null或者empty
        String[] items = StringUtil.split(blockContent.trim(), LF);
        int length = items.length;
        List list = new ArrayList<>(length);
        for (int i = 0; i < length; ++i){
            String item = items[i];

            //是否忽略
            if (isIgnore(item)){
                continue;
            }

            //---------------------------------------------------------------
            list.add(ItemSrcExtractor.extract(item, domain));
        }
        //---------------------------------------------------------------
        if (isNullOrEmpty(list)){
            if (LOGGER.isWarnEnabled()){
                LOGGER.warn(
                                "list isNullOrEmpty,need list to create links,now return emptyList(),blockContent info:[{}],domain:[{}]",
                                blockContent,
                                domain);
            }
            return emptyList();
        }

        return rework(blockContent, list);
    }

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

    /**
     * 是否忽略.
     * 
     * @param item
     * @return
     * @since 1.12.8
     */
    private static boolean isIgnore(String item){
        if (isNullOrEmpty(item)){// 忽视空行
            return true;
        }

        //---------------------------------------------------------------
        //since 1.11.1
        //
        //忽视html注释行
        return item.trim().startsWith("