package org.springframework.util;
/**
 * Miscellaneous {@link String} utility methods.
 * 
 */
public abstract class StringUtils {

package java.lang;

/**
 * Class {@code Object} is the root of the class hierarchy.
 * Every class has {@code Object} as a superclass. All objects,
 * including arrays, implement the methods of this class.
 */
public class Object {}

// 完全限定的類名
{@link java.lang.Character}

// 省略包名
{@link String}

// 省略類名，表示指向當(dāng)前的某個(gè)方法
{@link #length()}

// 包名.類名.方法名(參數(shù)類型)
{@link java.lang.String#charAt(int)}

package org.springframework.util;

/**
 * Miscellaneous {@link String} utility methods.
 *
 * <p>Mainly for internal use within the framework; consider
 * <a  rel="external nofollow" rel="external nofollow" >Apache's Commons Lang</a>
 * for a more comprehensive suite of {@code String} utilities.
 *
 * <p>This class delivers some simple functionality that should really be
 * provided by the core Java {@link String} and {@link StringBuilder}
 * classes. It also provides easy-to-use methods to convert between
 * delimited strings, such as CSV strings, and collections and arrays.
 *
 */
public abstract class StringUtils {

/**
* @param <E> the type of elements in this list
*/
public interface List<E> extends Collection<E> {}

// 純文本作者
@author Rod Johnson

// 純文本作者，郵件
@author Igor Hersht, igorh@ca.ibm.com

// 超鏈接郵件 純文本作者
@author <a href="mailto:ovidiu@cup.hp.com" rel="external nofollow" >Ovidiu Predescu</a>

// 純文本郵件
@author shane_curcuru@us.ibm.com

// 純文本 組織
@author Apache Software Foundation

// 超鏈接組織地址 純文本組織
@author <a  rel="external nofollow" > Apache Jakarta Turbine</a>

/**
 * @see IntStream
 * @see LongStream
 * @see DoubleStream
 * @see <a href="package-summary.html" rel="external nofollow" >java.util.stream</a>
 * /
public interface Stream<T> extends BaseStream<T, Stream<T>> {}

package java.util.stream;

/**
* @since 1.8
*/
public interface Stream<T> extends BaseStream<T, Stream<T>> {}

package org.springframework.util;

/**
* @since 16 April 2001
*/
public abstract class StringUtils {}

package com.sun.org.apache.xml.internal.resolver;
 /**
 * @version 1.0
 */
public class Resolver extends Catalog {}

/**
 * Check whether the given {@code CharSequence} contains actual <em>text</em>.
 * <p>More specifically, this method returns {@code true} if the
 * {@code CharSequence} is not {@code null}, its length is greater than
 * 0, and it contains at least one non-whitespace character.
 * <p><pre class="code">
 * StringUtils.hasText(null) = false
 * StringUtils.hasText("") = false
 * StringUtils.hasText(" ") = false
 * StringUtils.hasText("12345") = true
 * StringUtils.hasText(" 12345 ") = true
 * </pre>
 * @param str the {@code CharSequence} to check (may be {@code null})
 * @return {@code true} if the {@code CharSequence} is not {@code null},
 * its length is greater than 0, and it does not contain whitespace only
 * @see Character#isWhitespace
 */
public static boolean hasText(@Nullable CharSequence str) {
	return (str != null && str.length() > 0 && containsText(str));
}

{@code
   Person[] men = people.stream()
            .filter(p -> p.getGender() == MALE)
            .toArray(Person[]::new);
}

/**
* @param str the {@code CharSequence} to check (may be {@code null})
*/
public static boolean containsWhitespace(@Nullable CharSequence str) {}

/**
* @return {@code true} if the {@code String} is not {@code null}, its
*/
public static boolean hasText(@Nullable String str){}

/**
* @throws IllegalArgumentException when the given source contains invalid encoded sequences
*/
public static String uriDecode(String source, Charset charset){}

/**
* @exception IllegalArgumentException if <code>key</code> is null.
*/
public static Object get(String key) throws IllegalArgumentException {}

/**
* @exception IllegalArgumentException if <code>key</code> is null.
*/
public static Object get(String key) throws IllegalArgumentException {}

/** 默認(rèn)數(shù)量 {@value} */
private static final Integer QUANTITY = 1;

package org.springframework.util;

/**
 * Miscellaneous {@link String} utility methods.
 *
 * <p>Mainly for internal use within the framework; consider
 * <a  rel="external nofollow" rel="external nofollow" >Apache's Commons Lang</a>
 * for a more comprehensive suite of {@code String} utilities.
 *
 * <p>This class delivers some simple functionality that should really be
 * provided by the core Java {@link String} and {@link StringBuilder}
 * classes. It also provides easy-to-use methods to convert between
 * delimited strings, such as CSV strings, and collections and arrays.
 *
 * @author Rod Johnson
 * @author Juergen Hoeller
 * @author Keith Donald
 * @author Rob Harrop
 * @author Rick Evans
 * @author Arjen Poutsma
 * @author Sam Brannen
 * @author Brian Clozel
 * @since 16 April 2001
 */
public abstract class StringUtils {

	/**
	 * Decode the given encoded URI component value. Based on the following rules:
	 * <ul>
	 * <li>Alphanumeric characters {@code "a"} through {@code "z"}, {@code "A"} through {@code "Z"},
	 * and {@code "0"} through {@code "9"} stay the same.</li>
	 * <li>Special characters {@code "-"}, {@code "_"}, {@code "."}, and {@code "*"} stay the same.</li>
	 * <li>A sequence "{@code %<i>xy</i>}" is interpreted as a hexadecimal representation of the character.</li>
	 * </ul>
	 * 
	 * @param source the encoded String
	 * @param charset the character set
	 * @return the decoded value
	 * @throws IllegalArgumentException when the given source contains invalid encoded sequences
	 * @since 5.0
	 * @see java.net.URLDecoder#decode(String, String)
	 */
	public static String uriDecode(String source, Charset charset) {}

package com.example.demo;

/**
 * 類 {@code OrderService} 訂單服務(wù)層.
 *
 * <p> 主要包括 創(chuàng)建訂單、取消訂單、查詢訂單等功能更
 *
 * @see Order
 * @author <a href="mailto:mengday.zhang@gmail.com" rel="external nofollow" >Mengday Zhang</a>
 * @since 2018/5/12
 */
public class OrderService {

	/** 默認(rèn)數(shù)量 {@value} */
  private static final Integer QUANTITY = 1;

  /**
   * 創(chuàng)建訂單.
   *
   * <p> 創(chuàng)建訂單需要傳用戶id和商品列表(商品id和商品數(shù)量).
   *
   * <p><pre>{@code
   * 演示如何使用該方法
   * List<Goods> items = new ArrayList<>();
   * Goods goods = new Goods(1L, BigDecimal.ONE);
   * Goods goods2 = new Goods(2L, BigDecimal.TEN);
   * items.add(goods);
   * items.add(goods2);
   *
   * Order order1 = new Order();
   * order.setUserId("1");
   * order.setItems(items);
   * OrderService#createOrder(order);
   * }
   * </pre>
   *
   * @param order 訂單信息
   * @throws NullPointerException 參數(shù)信息為空
   * @exception IllegalArgumentException 數(shù)量不合法
   * @return 是否創(chuàng)建成功
   * @version 1.0
   * @see {@link Order}
   */
  public boolean createOrder(Order order) throws IllegalArgumentException{
    Objects.requireNonNull(order);

    List<Goods> items = order.getItems();
    items.forEach(goods -> {
      BigDecimal quantity = goods.getQuantity();
      if (quantity == null || BigDecimal.ZERO.compareTo(quantity) == 0) {
        throw new IllegalArgumentException();
      }
    });

    System.out.println("create order...");

    return true;
  }
}