/*
 * Copyright 2017, TeamDev Ltd. All rights reserved.
 *
 * Redistribution and use in source and/or binary forms, with or without
 * modification, must retain the above copyright notice and the following
 * disclaimer.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

package org.spine3.examples.todolist.c.aggregates;

import com.google.common.annotations.VisibleForTesting;
import org.spine3.examples.todolist.TaskDefinition;
import org.spine3.examples.todolist.TaskId;
import org.spine3.examples.todolist.TaskLabelIds;
import org.spine3.examples.todolist.context.TodoListBoundedContext;
import org.spine3.server.BoundedContext;
import org.spine3.server.aggregate.AggregateRoot;
import org.spine3.util.Environment;

/**
 * Aggregate root for the tasks.
 *
 * @author Illia Shepilov
 * @see AggregateRoot
 */
public class TaskAggregateRoot extends AggregateRoot<TaskId> {

    private static BoundedContext boundedContext;

    static {
        initBoundedContextIfNeeded();
    }

    /**
     * Obtains and sets the {@link BoundedContext} singleton instance,
     * if the {@link Environment} is not test environment.
     *
     * @see Environment#isTests()
     * @see TodoListBoundedContext#getInstance()
     */
    private static void initBoundedContextIfNeeded() {
        final boolean testEnv = Environment.getInstance()
                                           .isTests();
        if (!testEnv) {
            boundedContext = TodoListBoundedContext.getInstance();
        }
    }

    /**
     * Creates a new instance.
     *
     * @param id the ID of the aggregate
     */
    protected TaskAggregateRoot(TaskId id) {
        super(boundedContext, id);
    }

    /**
     * Returns {@link TaskAggregateRoot} instance according to the {@code TaskId}.
     *
     * @param id a task identifier
     * @return the aggregate root for the task
     */
    public static TaskAggregateRoot get(TaskId id) {
        return new TaskAggregateRoot(id);
    }

    /**
     * Returns the {@link TaskDefinition}.
     *
     * <p>Obtains the state from the {@code boundedContext}.
     *
     * @return the state for the {@link TaskDefinitionPart}.
     */
    public TaskDefinition getTaskDefinitionState() {
        final TaskDefinition result = getPartState(TaskDefinition.class);
        return result;
    }

    /**
     * Return the {@link TaskLabelIds}.
     *
     * <p>Obtains the state from the {@code boundedContext}.
     *
     * @return the state for the {@link TaskLabelsPart}
     */
    public TaskLabelIds getTaskLabelIdsState() {
        final TaskLabelIds result = getPartState(TaskLabelIds.class);
        return result;
    }

    /**
     * Injects the {@link BoundedContext} instance.
     *
     * @param boundedContext instance to inject
     */
    @VisibleForTesting
    public static void injectBoundedContext(BoundedContext boundedContext) {
        TaskAggregateRoot.boundedContext = boundedContext;
    }
}

@@ -2265,16 +2265,42 @@
 es a new
+ %7B@link TaskAggregateRoot%7D
  instanc

Fix documentation in the `TaskAggregateRoot` class.