org.asqatasun.rules.rgaa22.Rgaa22Rule06031.java Source code

Introduction

Here is the source code for org.asqatasun.rules.rgaa22.Rgaa22Rule06031.java

Source

/*
 * Asqatasun - Automated webpage assessment
 * Copyright (C) 2008-2015  Asqatasun.org
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 * Contact us by mail: asqatasun AT asqatasun DOT org
 */

package org.asqatasun.rules.rgaa22;

import org.apache.commons.lang3.StringUtils;
import org.jsoup.nodes.Element;
import org.asqatasun.entity.audit.TestSolution;
import org.asqatasun.processor.SSPHandler;
import org.asqatasun.ruleimplementation.AbstractPageRuleMarkupImplementation;
import org.asqatasun.ruleimplementation.ElementHandler;
import org.asqatasun.ruleimplementation.ElementHandlerImpl;
import org.asqatasun.ruleimplementation.TestSolutionHandler;
import org.asqatasun.rules.elementchecker.element.ElementPresenceChecker;
import org.asqatasun.rules.elementselector.AreaLinkElementSelector;
import org.asqatasun.rules.elementselector.CompositeLinkElementSelector;
import org.asqatasun.rules.elementselector.LinkElementSelector;
import static org.asqatasun.rules.keystore.AttributeStore.TARGET_ATTR;
import static org.asqatasun.rules.keystore.AttributeStore.TITLE_ATTR;
import static org.asqatasun.rules.keystore.HtmlElementStore.TEXT_ELEMENT2;
import static org.asqatasun.rules.keystore.RemarkMessageStore.CHECK_USER_IS_WARNED_WHEN_NEW_WINDOW_OPEN_MSG;
import org.asqatasun.rules.textbuilder.LinkTextElementBuilder;

/**
 * Implementation of the rule 6.3 of the referential RGAA 2.2.
 * <br/>
 * For more details about the implementation, refer to <a href="http://www.old-dot-org.org/en/content/rgaa22-rule-6-3">the rule 6.3 design page.</a>
 * @see <a href="http://rgaa.net/Presence-d-un-avertissement,82.html"> 6.3 rule specification </a>
 *
 * @author jkowalczyk
 */
public class Rgaa22Rule06031 extends AbstractPageRuleMarkupImplementation {

    private static final String PARENT_TARGET_VALUE = "_parent";
    private static final String SELF_TARGET_VALUE = "_self";
    private static final String TOP_TARGET_VALUE = "_top";

    private final ElementHandler<Element> compositeLinks = new ElementHandlerImpl();

    /**
     * Default constructor
     */
    public Rgaa22Rule06031() {
        super();
    }

    @Override
    protected void select(SSPHandler sspHandler) {
        /* the image link element selector */
        LinkElementSelector compositeLinkElementSelector = new CompositeLinkElementSelector(false, true);

        ElementHandler<Element> elHandler = new ElementHandlerImpl();

        compositeLinkElementSelector.selectElements(sspHandler, elHandler);
        for (Element el : compositeLinkElementSelector.getDecidableElements().get()) {
            if (doesElementHaveRequestedTargetAttribute(el)) {
                compositeLinks.add(el);
            }
        }

        LinkElementSelector areaLinkElementSelector = new AreaLinkElementSelector(false);
        elHandler.clean();
        areaLinkElementSelector.selectElements(sspHandler, elHandler);
        for (Element el : areaLinkElementSelector.getDecidableElements().get()) {
            if (doesElementHaveRequestedTargetAttribute(el)) {
                compositeLinks.add(el);
            }
        }
    }

    @Override
    protected void check(SSPHandler sspHandler, TestSolutionHandler testSolutionHandler) {
        if (compositeLinks.isEmpty()) {
            testSolutionHandler.addTestSolution(TestSolution.NOT_APPLICABLE);
            return;
        }
        ElementPresenceChecker epc = new ElementPresenceChecker(TestSolution.NEED_MORE_INFO,
                TestSolution.NOT_APPLICABLE, CHECK_USER_IS_WARNED_WHEN_NEW_WINDOW_OPEN_MSG, null, TEXT_ELEMENT2,
                TITLE_ATTR);
        epc.setTextElementBuilder(new LinkTextElementBuilder());
        epc.check(sspHandler, compositeLinks, testSolutionHandler);
    }

    /**
     * 
     * @param element
     * @return 
     */
    private boolean doesElementHaveRequestedTargetAttribute(Element element) {
        if (!element.hasAttr(TARGET_ATTR)) {
            return false;
        }
        String targetValue = element.attr(TARGET_ATTR);
        if (StringUtils.equalsIgnoreCase(targetValue, TOP_TARGET_VALUE)
                || StringUtils.equalsIgnoreCase(targetValue, PARENT_TARGET_VALUE)
                || StringUtils.equalsIgnoreCase(targetValue, SELF_TARGET_VALUE)) {
            return false;
        }
        return true;
    }

    @Override
    public int getSelectionSize() {
        return compositeLinks.size();
    }

}