<commit_before>/*
 * jlib - The Free Java Library
 * 
 *    http://www.jlib.org
 *    
 * Copyright (c) 2006-2008 <NAME>
 * 
 * jlib is distributed under the
 *
 *    COMMON PUBLIC LICENSE VERSION 1.0
 *
 *    http://www.opensource.org/licenses/cpl1.0.php
 */

package org.jlib.container.binaryrelation;

/**
 * Skeletal implementation of a {@link BinaryRelation}.
 * 
 * @param <LeftValue>
 *        type of the objects on the left hand side of the
 *        {@link BinaryRelation}
 * 
 * @param <RightValue>
 *        type of the objects on the right hand side of the
 *        {@link BinaryRelation}
 * 
 * @author <NAME>
 */
public abstract class AbstractInitializeableBinaryRelation<LeftValue, RightValue>
extends AbstractBinaryRelation<LeftValue, RightValue> {

    /**
     * Creates a new {@link AbstractInitializeableBinaryRelation}.
     */
    protected AbstractInitializeableBinaryRelation() {
        super();
    }

    /**
     * Associates the specified LeftValue with the specified RightValue in this
     * BinaryRelation.
     * 
     * @param leftValue
     *        LeftValue of the {@link Association}
     * 
     * @param rightValue
     *        RightValue of the {@link Association}
     * 
     * @throws IllegalAssociationException
     *         if some property of the specified {@link Association} prevents it
     *         from being added
     */
    protected abstract void associate(LeftValue leftValue, RightValue rightValue)
    throws IllegalAssociationException;
}
<commit_msg>Javadoc optimized<commit_after>/*
 * jlib - The Free Java Library
 * 
 *    http://www.jlib.org
 *    
 * Copyright (c) 2006-2008 <NAME>
 * 
 * jlib is distributed under the
 *
 *    COMMON PUBLIC LICENSE VERSION 1.0
 *
 *    http://www.opensource.org/licenses/cpl1.0.php
 */

package org.jlib.container.binaryrelation;

/**
 * Skeletal implementation of a {@link BinaryRelation} allowing to be filled
 * with data.
 * 
 * @param <LeftValue>
 *        type of the objects on the left hand side of the
 *        {@link BinaryRelation}
 * 
 * @param <RightValue>
 *        type of the objects on the right hand side of the
 *        {@link BinaryRelation}
 * 
 * @author <NAME>
 */
public abstract class AbstractInitializeableBinaryRelation<LeftValue, RightValue>
extends AbstractBinaryRelation<LeftValue, RightValue> {

    /**
     * Creates a new {@link AbstractInitializeableBinaryRelation}.
     */
    protected AbstractInitializeableBinaryRelation() {
        super();
    }

    /**
     * Associates the specified LeftValue with the specified RightValue in this
     * BinaryRelation.
     * 
     * @param leftValue
     *        LeftValue of the {@link Association}
     * 
     * @param rightValue
     *        RightValue of the {@link Association}
     * 
     * @throws IllegalAssociationException
     *         if some property of the specified {@link Association} prevents it
     *         from being added
     */
    protected abstract void associate(LeftValue leftValue, RightValue rightValue)
    throws IllegalAssociationException;
}

{'fraction_non_alphanumeric': 0.08948909860071591, 'fraction_numerical': 0.0078099576960624795, 'mean_word_length': 2.6421800947867298, 'pattern_counts': {'":': 0, '<': 15, '<?xml version=': 0, '>': 15, 'https://': 0, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5331046', 'n_tokens_mistral': 883, 'n_tokens_neox': 834, 'n_words': 261}