MutableNode.java

1
/*******************************************************************************
2
 * Copyright (C) 2026, Leo Galambos
3
 * All rights reserved.
4
 * 
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions are met:
7
 * 
8
 * 1. Redistributions of source code must retain the above copyright notice,
9
 *    this list of conditions and the following disclaimer.
10
 * 
11
 * 2. Redistributions in binary form must reproduce the above copyright notice,
12
 *    this list of conditions and the following disclaimer in the documentation
13
 *    and/or other materials provided with the distribution.
14
 * 
15
 * 3. All advertising materials mentioning features or use of this software must
16
 *    display the following acknowledgement:
17
 *    This product includes software developed by the Egothor project.
18
 * 
19
 * 4. Neither the name of the copyright holder nor the names of its contributors
20
 *    may be used to endorse or promote products derived from this software
21
 *    without specific prior written permission.
22
 * 
23
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
24
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
27
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
28
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
29
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
30
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
31
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
32
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
33
 * POSSIBILITY OF SUCH DAMAGE.
34
 ******************************************************************************/
35
package org.egothor.stemmer.trie;
36
37
import java.util.LinkedHashMap;
38
import java.util.Map;
39
40
/**
41
 * Mutable build-time node.
42
 *
43
 * <p>
44
 * The maps exposed by the accessors are the internal mutable backing state of
45
 * the node. They are returned directly for efficiency and are intended only for
46
 * closely related trie-building infrastructure.
47
 *
48
 * @param <V> value type
49
 */
50
public final class MutableNode<V> {
51
52
    /**
53
     * Child nodes indexed by transition character.
54
     */
55
    private final Map<Character, MutableNode<V>> children;
56
57
    /**
58
     * Local terminal value counts stored exactly at this node.
59
     */
60
    private final Map<V, Integer> valueCounts;
61
62
    /**
63
     * Creates an empty node.
64
     */
65
    public MutableNode() {
66
        this.children = new LinkedHashMap<>();
67
        this.valueCounts = new LinkedHashMap<>();
68
    }
69
70
    /**
71
     * Returns the internal child-node map indexed by transition character.
72
     *
73
     * <p>
74
     * The returned map is the internal mutable backing state of this node and is
75
     * exposed only for efficient cooperation with trie-building infrastructure.
76
     *
77
     * @return internal child-node map
78
     */
79
    public Map<Character, MutableNode<V>> children() {
80 1 1. children : replaced return value with Collections.emptyMap for org/egothor/stemmer/trie/MutableNode::children → KILLED
        return this.children;
81
    }
82
83
    /**
84
     * Returns the internal local terminal value-count map.
85
     *
86
     * <p>
87
     * The returned map is the internal mutable backing state of this node and is
88
     * exposed only for efficient cooperation with trie-building infrastructure.
89
     *
90
     * @return internal local value-count map
91
     */
92
    public Map<V, Integer> valueCounts() {
93 1 1. valueCounts : replaced return value with Collections.emptyMap for org/egothor/stemmer/trie/MutableNode::valueCounts → KILLED
        return this.valueCounts;
94
    }
95
}

Mutations

80

1.1
Location : children
Killed by : org.egothor.stemmer.trie.MutableNodeTest.[engine:junit-jupiter]/[class:org.egothor.stemmer.trie.MutableNodeTest]/[method:shouldExposeMutableBackingChildrenMap()]
replaced return value with Collections.emptyMap for org/egothor/stemmer/trie/MutableNode::children → KILLED

93

1.1
Location : valueCounts
Killed by : org.egothor.stemmer.trie.MutableNodeTest.[engine:junit-jupiter]/[class:org.egothor.stemmer.trie.MutableNodeTest]/[method:shouldExposeMutableBackingValueCountsMap()]
replaced return value with Collections.emptyMap for org/egothor/stemmer/trie/MutableNode::valueCounts → KILLED

Active mutators

Tests examined


Report generated by PIT 1.22.1