us.codecraft.webmagic.model.annotation.ExtractByUrl Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of webmagic-extension Show documentation

There is a newer version: 1.0.2

package us.codecraft.webmagic.model.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

/**
 * Define a extractor to extract data in url of current page. Only regex can be used. 

 *
 * @author [email protected] 

 * @since 0.2.0
 */
@Retention(java.lang.annotation.RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD})
public @interface ExtractByUrl {

    /**
     * Extractor expression, only regex can be used
     *
     * @return extractor expression
     */
    String value() default "";

    /**
     * Define whether the field can be null.

     * If set to 'true' and the extractor get no result, the entire class will be discarded. 

     *
     * @return whether the field can be null
     */
    boolean notNull() default false;

    /**
     * Define whether the extractor return more than one result.
     * When set to 'true', the extractor return a list of string (so you should define the field as List). 

     *
     * Deprecated since 0.4.2. This option is determined automatically by the class of field.
     * @deprecated since 0.4.2
     * @return whether the extractor return more than one result
     */
    boolean multi() default false;

}