net.digitalid.utility.collaboration.annotations.TODO Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of utility-collaboration Show documentation

The newest version!

package net.digitalid.utility.collaboration.annotations;

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

import javax.annotation.Nonnull;

import net.digitalid.utility.collaboration.enumerations.Author;
import net.digitalid.utility.collaboration.enumerations.Priority;

/**
 * This annotation indicates a task that still needs to be done.
 * 
 * @see Question
 * @see Review
 */
@Documented
@Retention(RetentionPolicy.SOURCE)
@Target({ElementType.TYPE, ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.FIELD})
public @interface TODO {
    
    /**
     * Returns a description of the task that needs to be done.
     */
    @Nonnull String task();
    
    /**
     * Returns the date when this todo was created.
     * (The desired format is 'YYYY-MM-DD'.)
     */
    @Nonnull String date();
    
    /**
     * Returns the author that created this todo.
     */
    @Nonnull Author author();
    
    /**
     * Returns the programmer to whom the task is assigned.
     */
    @Nonnull Author assignee() default Author.ANYONE;
    
    /**
     * Returns the priority with which the task should be done.
     */
    @Nonnull Priority priority() default Priority.UNSPECIFIED;
    
}