Нужны комментарии

/**
 * Указываем, что класс принадлежит данному пакету 
 */
package ru.yandex.qatools.matchers.uri;
/**
 * импорт класса, создающего описание матчера
 */
import org.hamcrest.Description;
/**
 * импорт класса, делающий возможным использование аннотаций
 */
import org.hamcrest.Factory;
/**
 * импорт класса для использования и реализации вычислителей
 */
import org.hamcrest.TypeSafeDiagnosingMatcher;
/**
 * 
 */
import ru.lanwen.diff.uri.UriDiffer;
/**
 * 
 */
import ru.lanwen.diff.uri.core.UriDiff;
/**
 * 
 */
import ru.lanwen.diff.uri.core.filters.UriDiffFilter;
/**
 * импорт класса, для использования работы с URI 
 */  
import java.net.URI;
/**
 * Подключаем библиотеку интерфейса списка массивов
 */
import java.util.ArrayList;
/**
 * Подключаем библиотеку интерфейса списка
 */
import java.util.List;
/**
 * импорт статического класса для преобразования массива фиксированного размера
 */
import static java.util.Arrays.asList;
/**
 * импорт статического класса для проверки аргументов(не является null не содержит каких-либо элементов null)
 */
import static org.apache.commons.lang3.Validate.noNullElements;
/**
 * импорт статического класса для проверки аргументов
 */
import static org.apache.commons.lang3.Validate.notNull;
 
/**
 * User: lanwen
 * Date: 30.09.14
 * Time: 20:01
 * Uses lib: [url]https://github.com/yandex-qatools/uri-differ[/url] as core to compare URIs
 * Can use filters to prepare URIs
 *
 * Provide message:
 * {@code Expected: URI same as: <http://ya.ru>
 *             but: was <http://yandex.ru>
 *            diff: "http://[ya->yandex].ru"
 * }
 */
/**
 * объявляем класс общедоступного типа, который наследует члены ласса, реализующего матчеры
 */
public class SameAsURIMatcher extends TypeSafeDiagnosingMatcher<URI> {
/**
 * объявляем URI, доступную в этом классе
 */
    private URI expectedUri;
/**
 * инициализация элементов массива
 */ 
    private List<UriDiffFilter> filters = new ArrayList<>();
/**
 * объявляем переменные доступные только внутри этого класса
 */
    private SameAsURIMatcher(URI expectedUri) {
/**
 * Указываем, что к данной переменной присваивается значение
 */
        this.expectedUri = expectedUri;
    }
/**
 * аннотация указывает на то, что далее метод базового класса будет переопределен
 */
    @Override
/**
 * объявляем переменные доступные только для классов в одном пакете и в подклассах
 */
    protected boolean matchesSafely(URI actual, Description mismatchDescription) {
/**
 * 
 */ 
UriDiff changes = UriDiffer.diff().expected(expectedUri).actual(actual).filter(filters).changes();
        mismatchDescription.appendText("was ").appendValue(actual)
                .appendText("\n\tdiff: ").appendValue(changes.report()).appendText("\n");
/**
 * проверка изменений и возвращение их
 */       
 return !changes.hasChanges();
    }
/**
 * аннотация указывает на то, что далее метод базового класса будет переопределен
 */
    @Override
/**
 * Создаем общедоступный класс для описания .
 */
    public void describeTo(Description description) {
/**
 * Добавляем текст в конец строки с переменной 
 */
        description.appendText("URI same as: ").appendValue(expectedUri);
    }
/**
 * объявляем общедоступные переменные
 */
    public SameAsURIMatcher filteredWith(UriDiffFilter... filters) {
/**
 * 
 */
        this.filters.addAll(asList(
                noNullElements(notNull(filters, "Argument <filters> can't be null"), "Can't use null-filters")
        ));
/**
 * возвращаем значение
 */
        return this; }
/**
 * аннотация, которой помечается метод, возвращающий объект, используемый в тестовом классе
 */
    @Factory
/**
 * объявляем общедоступные статические переменные
 */
    public static SameAsURIMatcher sameAsURI(URI expectedUri) {
/**
 * возвращаем значение
 */
        return new SameAsURIMatcher(expectedUri);
    }
}