diff --git a/CHANGELOG b/CHANGELOG index 5ee231c..fcf8fdd 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -1,6 +1,15 @@ CHANGELOG ========= +0.5.0 +------ + +* Make ImmutableNodeItem extend NodeItem +* Upgrade kemitix-parent to 2.1.0 +* Upgrade lombok to 1.16.10 +* Upgrade assertj to 3.5.2 +* + 0.4.0 ------ diff --git a/LICENSE b/LICENSE.txt similarity index 99% rename from LICENSE rename to LICENSE.txt index c401abb..00c515a 100644 --- a/LICENSE +++ b/LICENSE.txt @@ -1,3 +1,4 @@ +/* The MIT License (MIT) Copyright (c) 2016 Paul Campbell @@ -19,3 +20,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +*/ diff --git a/pom.xml b/pom.xml index af09752..c7833d8 100644 --- a/pom.xml +++ b/pom.xml @@ -2,7 +2,7 @@ 4.0.0 node - 0.4.2 + 0.5.0 jar Node @@ -11,11 +11,12 @@ net.kemitix kemitix-parent - 2.0.0 + 2.1.0 - 3.4.1 + 1.16.10 + 3.5.2 4.2.0 2.1.0 @@ -49,7 +50,7 @@ org.projectlombok lombok - 1.16.8 + ${lombok.version} junit diff --git a/src/main/java/net/kemitix/node/AbstractNodeItem.java b/src/main/java/net/kemitix/node/AbstractNodeItem.java deleted file mode 100644 index 1fe6eab..0000000 --- a/src/main/java/net/kemitix/node/AbstractNodeItem.java +++ /dev/null @@ -1,155 +0,0 @@ -package net.kemitix.node; - -import lombok.NonNull; - -import java.util.HashSet; -import java.util.List; -import java.util.Optional; -import java.util.Set; - -/** - * An abstract node item, providing default implementations for most read-only - * operations. - * - * @author Paul Campbell - * - * @param the type of data stored in each node - */ -abstract class AbstractNodeItem implements Node { - - private T data; - - private String name; - - private Node parent; - - private final Set> children; - - protected AbstractNodeItem( - final T data, final String name, final Node parent, - final Set> children) { - this.data = data; - this.name = name; - this.parent = parent; - this.children = children; - } - - @Override - public String getName() { - return name; - } - - @Override - public Optional getData() { - return Optional.ofNullable(data); - } - - @Override - public boolean isEmpty() { - return data == null; - } - - @Override - public Optional> getParent() { - return Optional.ofNullable(parent); - } - - @Override - public Set> getChildren() { - return new HashSet<>(children); - } - - /** - * Fetches the node for the child if present. - * - * @param child the child's data to search for - * - * @return an {@link Optional} containing the child node if found - */ - @Override - public Optional> findChild(@NonNull final T child) { - return children.stream().filter(node -> { - final Optional d = node.getData(); - return d.isPresent() && d.get().equals(child); - }).findAny(); - } - - @Override - public Node getChild(final T child) { - return findChild(child).orElseThrow( - () -> new NodeException("Child not found")); - } - - /** - * Checks if the node is an ancestor. - * - * @param node the potential ancestor - * - * @return true if the node is an ancestor - */ - @Override - public boolean isDescendantOf(final Node node) { - return parent != null && (node.equals(parent) || parent.isDescendantOf( - node)); - } - - /** - * Walks the node tree using the path to select each child. - * - * @param path the path to the desired child - * - * @return the child or null - */ - @Override - public Optional> findInPath(@NonNull final List path) { - if (path.isEmpty()) { - return Optional.empty(); - } - Node current = this; - for (T item : path) { - final Optional> child = current.findChild(item); - if (child.isPresent()) { - current = child.get(); - } else { - current = null; - break; - } - } - return Optional.ofNullable(current); - } - - @Override - public Optional> findChildByName(@NonNull final String named) { - return children.stream() - .filter(n -> n.getName().equals(named)) - .findAny(); - } - - @Override - public Node getChildByName(final String named) { - return findChildByName(named).orElseThrow( - () -> new NodeException("Named child not found")); - } - - @Override - public String drawTree(final int depth) { - final StringBuilder sb = new StringBuilder(); - final String unnamed = "(unnamed)"; - if (isNamed()) { - sb.append(formatByDepth(name, depth)); - } else if (!children.isEmpty()) { - sb.append(formatByDepth(unnamed, depth)); - } - getChildren().forEach(c -> sb.append(c.drawTree(depth + 1))); - return sb.toString(); - } - - private String formatByDepth(final String value, final int depth) { - return String.format("[%1$" + (depth + value.length()) + "s]\n", value); - } - - @Override - public boolean isNamed() { - return name != null && name.length() > 0; - } -} diff --git a/src/main/java/net/kemitix/node/ImmutableNodeItem.java b/src/main/java/net/kemitix/node/ImmutableNodeItem.java index dbc85ec..547dde3 100644 --- a/src/main/java/net/kemitix/node/ImmutableNodeItem.java +++ b/src/main/java/net/kemitix/node/ImmutableNodeItem.java @@ -1,3 +1,27 @@ +/* +The MIT License (MIT) + +Copyright (c) 2016 Paul Campbell + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + package net.kemitix.node; import java.util.List; @@ -11,28 +35,51 @@ import java.util.Set; * getData()} they could then modify the original data within the node. This * wouldn't affect the integrity of the node tree structure, however.

* - * @author Paul Campbell - * * @param the type of data stored in each node + * + * @author Paul Campbell (pcampbell@kemitix.net) */ -final class ImmutableNodeItem extends AbstractNodeItem { +final class ImmutableNodeItem extends NodeItem { private static final String IMMUTABLE_OBJECT = "Immutable object"; private ImmutableNodeItem( - final T data, final String name, final Node parent, - final Set> children) { - super(data, name, parent, children); + final T data, final String name, final Node parent, final Set> children + ) { + super(data, name, null, children); + forceParent(parent); } + /** + * Creates a new immutable root node. + * + * @param data the data of the node + * @param name the name of the node + * @param children the children of the node + * @param the type of the data in the node + * + * @return the new node tree's root node + */ static ImmutableNodeItem newRoot( - final T data, final String name, final Set> children) { + final T data, final String name, final Set> children + ) { return new ImmutableNodeItem<>(data, name, null, children); } + /** + * Creates a new immutable subtree from this child. + * + * @param data the data of the node + * @param name the name of the node + * @param parent the mutable parent of the node + * @param children the children of the node + * @param the type of the data in the node + * + * @return the new immutable node + */ static ImmutableNodeItem newChild( - final T data, final String name, final Node parent, - final Set> children) { + final T data, final String name, final Node parent, final Set> children + ) { return new ImmutableNodeItem<>(data, name, parent, children); } @@ -71,12 +118,6 @@ final class ImmutableNodeItem extends AbstractNodeItem { throw new UnsupportedOperationException(IMMUTABLE_OBJECT); } - @Override - public Node findOrCreateChild(final T child) { - return findChild(child).orElseThrow( - () -> new UnsupportedOperationException(IMMUTABLE_OBJECT)); - } - @Override public void insertInPath(final Node node, final String... path) { throw new UnsupportedOperationException(IMMUTABLE_OBJECT); @@ -91,5 +132,4 @@ final class ImmutableNodeItem extends AbstractNodeItem { public void removeParent() { throw new UnsupportedOperationException(IMMUTABLE_OBJECT); } - } diff --git a/src/main/java/net/kemitix/node/Node.java b/src/main/java/net/kemitix/node/Node.java index a5daf12..e354227 100644 --- a/src/main/java/net/kemitix/node/Node.java +++ b/src/main/java/net/kemitix/node/Node.java @@ -1,3 +1,27 @@ +/* +The MIT License (MIT) + +Copyright (c) 2016 Paul Campbell + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + package net.kemitix.node; import java.util.List; @@ -7,9 +31,9 @@ import java.util.Set; /** * An interface for tree node items. * - * @author Paul Campbell - * * @param the type of data held in each node + * + * @author Paul Campbell (pcampbell@kemitix.net) */ public interface Node { @@ -32,8 +56,7 @@ public interface Node { /** * Fetch the data held within the node. * - * @return an Optional containing the node's data, or empty if the node has - * none + * @return an Optional containing the node's data, or empty if the node has none */ Optional getData(); @@ -106,20 +129,6 @@ public interface Node { */ void createDescendantLine(List descendants); - /** - * Looks for a child node and returns it, creating a new child node if one - * isn't found. - * - * @param child the child's data to search or create with - * - * @return the found or created child node - * - * @deprecated use {@code node.findChild(child).orElseGet(() -> - * node.createChild(child))}; - */ - @Deprecated - Node findOrCreateChild(T child); - /** * Fetches the node for the child if present. * @@ -135,8 +144,6 @@ public interface Node { * @param child the child's data to search for * * @return the child node if found - * - * @throws NodeException if the node is not found */ Node getChild(T child); @@ -183,8 +190,6 @@ public interface Node { * @param name the name of the child * * @return the node - * - * @throws NodeException if the node is not found */ Node getChildByName(String name); diff --git a/src/main/java/net/kemitix/node/NodeException.java b/src/main/java/net/kemitix/node/NodeException.java index 7f84643..f401b6e 100644 --- a/src/main/java/net/kemitix/node/NodeException.java +++ b/src/main/java/net/kemitix/node/NodeException.java @@ -1,9 +1,33 @@ +/* +The MIT License (MIT) + +Copyright (c) 2016 Paul Campbell + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + package net.kemitix.node; /** * Represents an error within the tree node. * - * @author pcampbell + * @author Paul Campbell (pcampbell@kemitix.net) */ @SuppressWarnings("serial") public class NodeException extends RuntimeException { diff --git a/src/main/java/net/kemitix/node/NodeItem.java b/src/main/java/net/kemitix/node/NodeItem.java index 12a7cef..e4d605a 100644 --- a/src/main/java/net/kemitix/node/NodeItem.java +++ b/src/main/java/net/kemitix/node/NodeItem.java @@ -1,3 +1,27 @@ +/* +The MIT License (MIT) + +Copyright (c) 2016 Paul Campbell + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + package net.kemitix.node; import lombok.NonNull; @@ -12,62 +36,46 @@ import java.util.Set; /** * Represents a tree of nodes. * - * @author Paul Campbell - * * @param the type of data stored in each node + * + * @author Paul Campbell (pcampbell@kemitix.net) */ class NodeItem implements Node { - private T data; - private final Set> children = new HashSet<>(); + private T data; + private Node parent; private String name; /** - * Create named root node. + * Constructor. * - * @param data the data or null - * @param name the name + * @param data the data of the node + * @param name the name of the node + * @param parent the parent of the node, or null for a root node + * @param children the children of the node - must not be null */ - NodeItem(final T data, final String name) { - this(data); - this.name = name; - } - - /** - * Create unnamed root node. - * - * @param data the data or null - */ - NodeItem(final T data) { - this.data = data; - } - - /** - * Creates a node with a parent. - * - * @param data the data or null - * @param parent the parent node - */ - NodeItem(final T data, final Node parent) { - this.data = data; - setParent(parent); - } - - /** - * Creates a named node with a parent. - * - * @param data the data or null - * @param name the name - * @param parent the parent node - */ - NodeItem(final T data, final String name, final Node parent) { + NodeItem( + final T data, final String name, final Node parent, @NonNull final Set> children + ) { this.data = data; this.name = name; - setParent(parent); + if (parent != null) { + doSetParent(parent); + } + this.children.addAll(children); + } + + /** + * Sets the parent of a node without updating the parent in the process as {@link #setParent(Node)} does. + * + * @param newParent The new parent node + */ + protected void forceParent(final Node newParent) { + this.parent = newParent; } @Override @@ -100,6 +108,28 @@ class NodeItem implements Node { return Optional.ofNullable(parent); } + /** + * Make the current node a direct child of the parent. + * + * @param parent the new parent node + */ + @Override + public void setParent(@NonNull final Node parent) { + doSetParent(parent); + } + + private void doSetParent(@NonNull final Node newParent) { + if (this.equals(newParent) || newParent.isDescendantOf(this)) { + throw new NodeException("Parent is a descendant"); + } + if (this.parent != null) { + this.parent.getChildren() + .remove(this); + } + this.parent = newParent; + newParent.addChild(this); + } + @Override public Set> getChildren() { return children; @@ -117,20 +147,20 @@ class NodeItem implements Node { children.add(child); // update the child's parent if they don't have one or it is not this val childParent = child.getParent(); - if (!childParent.isPresent() || !childParent.get().equals(this)) { + if (!childParent.isPresent() || !childParent.get() + .equals(this)) { child.setParent(this); } } private void verifyChildWithSameNameDoesNotAlreadyExist( - final @NonNull Node child) { + final @NonNull Node child + ) { if (child.isNamed()) { - findChildByName(child.getName()) - .filter(existingChild -> existingChild != child) - .ifPresent(existingChild -> { - throw new NodeException( - "Node with that name already exists here"); - }); + findChildByName(child.getName()).filter(existingChild -> existingChild != child) + .ifPresent(existingChild -> { + throw new NodeException("Node with that name already exists here"); + }); } } @@ -149,7 +179,7 @@ class NodeItem implements Node { */ @Override public Node createChild(@NonNull final T child) { - return new NodeItem<>(child, this); + return new NodeItem<>(child, "", this, new HashSet<>()); } @Override @@ -169,28 +199,13 @@ class NodeItem implements Node { @Override public void createDescendantLine(@NonNull final List descendants) { if (!descendants.isEmpty()) { - findOrCreateChild(descendants.get(0)).createDescendantLine( - descendants.subList(1, descendants.size())); + val child = descendants.get(0); + val remainingLine = descendants.subList(1, descendants.size()); + findChild(child).orElseGet(() -> createChild(child)) + .createDescendantLine(remainingLine); } } - /** - * Looks for a child node and returns it, creating a new child node if one - * isn't found. - * - * @param child the child's data to search or create with - * - * @return the found or created child node - * - * @deprecated use node.findChild(child).orElseGet(() -> node.createChild - * (child)); - */ - @Override - @Deprecated - public Node findOrCreateChild(@NonNull final T child) { - return findChild(child).orElseGet(() -> createChild(child)); - } - /** * Fetches the node for the child if present. * @@ -200,19 +215,15 @@ class NodeItem implements Node { */ @Override public Optional> findChild(@NonNull final T child) { - return children.stream().filter(node -> { - final Optional d = node.getData(); - return d.isPresent() && d.get().equals(child); - }).findAny(); + return children.stream() + .filter(node -> child.equals(node.getData() + .orElseGet(() -> null))) + .findFirst(); } @Override public Node getChild(final T child) { - Optional> optional = findChild(child); - if (optional.isPresent()) { - return optional.get(); - } - throw new NodeException("Child not found"); + return findChild(child).orElseThrow(() -> new NodeException("Child not found")); } /** @@ -224,25 +235,7 @@ class NodeItem implements Node { */ @Override public boolean isDescendantOf(final Node node) { - return parent != null && (node.equals(parent) || parent.isDescendantOf( - node)); - } - - /** - * Make the current node a direct child of the parent. - * - * @param parent the new parent node - */ - @Override - public final void setParent(@NonNull final Node parent) { - if (this.equals(parent) || parent.isDescendantOf(this)) { - throw new NodeException("Parent is a descendant"); - } - if (this.parent != null) { - this.parent.getChildren().remove(this); - } - this.parent = parent; - parent.addChild(this); + return parent != null && (node.equals(parent) || parent.isDescendantOf(node)); } /** @@ -258,14 +251,9 @@ class NodeItem implements Node { return Optional.empty(); } Node current = this; - for (T item : path) { - final Optional> child = current.findChild(item); - if (child.isPresent()) { - current = child.get(); - } else { - current = null; - break; - } + for (int i = 0, pathSize = path.size(); i < pathSize && current != null; i++) { + current = current.findChild(path.get(i)) + .orElse(null); } return Optional.ofNullable(current); } @@ -275,11 +263,9 @@ class NodeItem implements Node { if (path.length == 0) { insertChild(nodeItem); } else { - val item = path[0]; - findChildByName(item) - .orElseGet(() -> new NodeItem<>(null, item, this)) - .insertInPath(nodeItem, - Arrays.copyOfRange(path, 1, path.length)); + val nextInPath = path[0]; + findChildByName(nextInPath).orElseGet(() -> new NodeItem<>(null, nextInPath, this, new HashSet<>())) + .insertInPath(nodeItem, Arrays.copyOfRange(path, 1, path.length)); } } @@ -299,10 +285,10 @@ class NodeItem implements Node { val existing = childByName.get(); if (existing.isEmpty()) { // place any data in the new node into the existing empty node - nodeItem.getData().ifPresent(existing::setData); + nodeItem.getData() + .ifPresent(existing::setData); } else { - throw new NodeException("A non-empty node named '" - + nodeItem.getName() + "' already exists here"); + throw new NodeException("A non-empty node named '" + nodeItem.getName() + "' already exists here"); } } else { // nothing with the same name exists @@ -313,8 +299,9 @@ class NodeItem implements Node { @Override public Optional> findChildByName(@NonNull final String named) { return children.stream() - .filter((Node t) -> t.getName().equals(named)) - .findAny(); + .filter((Node t) -> t.getName() + .equals(named)) + .findAny(); } @Override diff --git a/src/main/java/net/kemitix/node/Nodes.java b/src/main/java/net/kemitix/node/Nodes.java index ecc5f39..ffa8f74 100644 --- a/src/main/java/net/kemitix/node/Nodes.java +++ b/src/main/java/net/kemitix/node/Nodes.java @@ -1,13 +1,37 @@ +/* +The MIT License (MIT) + +Copyright (c) 2016 Paul Campbell + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + package net.kemitix.node; -import java.util.Optional; +import java.util.HashSet; import java.util.Set; import java.util.stream.Collectors; /** * Utility class for {@link Node} items. * - * @author pcampbell + * @author Paul Campbell (pcampbell@kemitix.net) */ public final class Nodes { @@ -23,7 +47,7 @@ public final class Nodes { * @return the new node */ public static Node unnamedRoot(final T data) { - return new NodeItem<>(data); + return new NodeItem<>(data, "", null, new HashSet<>()); } /** @@ -36,7 +60,7 @@ public final class Nodes { * @return the new node */ public static Node namedRoot(final T data, final String name) { - return new NodeItem<>(data, name); + return new NodeItem<>(data, name, null, new HashSet<>()); } /** @@ -49,7 +73,7 @@ public final class Nodes { * @return the new node */ public static Node unnamedChild(final T data, final Node parent) { - return new NodeItem<>(data, parent); + return new NodeItem<>(data, "", parent, new HashSet<>()); } /** @@ -63,8 +87,9 @@ public final class Nodes { * @return the new node */ public static Node namedChild( - final T data, final String name, final Node parent) { - return new NodeItem<>(data, name, parent); + final T data, final String name, final Node parent + ) { + return new NodeItem<>(data, name, parent, new HashSet<>()); } /** @@ -76,12 +101,13 @@ public final class Nodes { * @return the immutable copy of the tree */ public static Node asImmutable(final Node root) { - if (root.getParent().isPresent()) { + if (root.getParent() + .isPresent()) { throw new IllegalArgumentException("source must be the root node"); } final Set> children = getImmutableChildren(root); - return ImmutableNodeItem.newRoot(root.getData().orElse(null), - root.getName(), children); + return ImmutableNodeItem.newRoot(root.getData() + .orElse(null), root.getName(), children); } private static Set> getImmutableChildren(final Node source) { @@ -92,16 +118,13 @@ public final class Nodes { } private static Node asImmutableChild( - final Node source) { - final Optional> sourceParent = source.getParent(); - if (sourceParent.isPresent()) { - return ImmutableNodeItem.newChild(source.getData().orElse(null), - source.getName(), sourceParent.get(), - getImmutableChildren(source)); - } else { - throw new IllegalArgumentException( - "source must not be the root node"); - } + final Node source + ) { + return ImmutableNodeItem.newChild(source.getData() + .orElse(null), source.getName(), source.getParent() + .orElse(null), + getImmutableChildren(source) + ); } } diff --git a/src/main/java/net/kemitix/node/package-info.java b/src/main/java/net/kemitix/node/package-info.java index 382684c..49ea507 100644 --- a/src/main/java/net/kemitix/node/package-info.java +++ b/src/main/java/net/kemitix/node/package-info.java @@ -1,4 +1,28 @@ +/* +The MIT License (MIT) + +Copyright (c) 2016 Paul Campbell + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ /** * Tree Node implementation. */ + package net.kemitix.node; diff --git a/src/test/java/net/kemitix/node/ImmutableNodeItemTest.java b/src/test/java/net/kemitix/node/ImmutableNodeItemTest.java index 91eee8a..3997ef3 100644 --- a/src/test/java/net/kemitix/node/ImmutableNodeItemTest.java +++ b/src/test/java/net/kemitix/node/ImmutableNodeItemTest.java @@ -126,7 +126,7 @@ public class ImmutableNodeItemTest { immutableNode = Nodes.asImmutable(Nodes.unnamedRoot("subject")); expectImmutableException(); //when - immutableNode.setParent(null); + immutableNode.setParent(Nodes.unnamedRoot("child")); } @Test @@ -222,19 +222,6 @@ public class ImmutableNodeItemTest { } } - /** - * Test that if we pass null we get an exception. - */ - @Test - public void findOrCreateChildShouldThrowNPEFWhenChildIsNull() { - //given - immutableNode = Nodes.asImmutable(Nodes.unnamedRoot("subject")); - exception.expect(NullPointerException.class); - exception.expectMessage("child"); - //when - immutableNode.findOrCreateChild(null); - } - /** * Test that we throw an exception when passed null. */ @@ -433,22 +420,11 @@ public class ImmutableNodeItemTest { } @Test - public void findOrCreateChildShouldReturnChildWhenChildIsFound() { + public void AsImmutableShouldThrowIAEWhenNotRoot() { //given - val root = Nodes.unnamedRoot(""); - Nodes.namedChild("child", "child", root); - immutableNode = Nodes.asImmutable(root); + exception.expect(IllegalArgumentException.class); + exception.expectMessage("source must be the root node"); //when - val found = immutableNode.findOrCreateChild("child"); - assertThat(found).extracting(Node::getName).contains("child"); - } - - @Test - public void findOrCreateChildShouldThrowExceptionWhenChildNotFound() { - //given - immutableNode = Nodes.asImmutable(Nodes.unnamedRoot("")); - expectImmutableException(); - //when - immutableNode.findOrCreateChild("child"); + Nodes.asImmutable(Nodes.unnamedChild("child", Nodes.unnamedRoot("root"))); } } diff --git a/src/test/java/net/kemitix/node/NodeItemTest.java b/src/test/java/net/kemitix/node/NodeItemTest.java index 2702ae0..0a92e75 100644 --- a/src/test/java/net/kemitix/node/NodeItemTest.java +++ b/src/test/java/net/kemitix/node/NodeItemTest.java @@ -10,6 +10,7 @@ import org.junit.rules.ExpectedException; import java.util.Arrays; import java.util.Collections; import java.util.Optional; +import java.util.Set; import static org.assertj.core.api.Assertions.assertThat; @@ -84,6 +85,17 @@ public class NodeItemTest { .contains(parent); } + @Test + public void shouldAddAsChildWhenCreatedWithParent() { + //given + final Node root = Nodes.namedRoot("root data", "root name"); + //when + final Node child = Nodes.namedChild("child data", "child name", root); + //then + final Set> children = root.getChildren(); + assertThat(children).containsExactly(child); + } + /** * Test that setting the parent on a node where the proposed parent is a * child of the node throws an exception. @@ -457,52 +469,6 @@ public class NodeItemTest { + "is created").isEmpty(); } - /** - * Test that we can find a child of a node. - */ - @Test - public void shouldFindExistingChildNode() { - //given - node = Nodes.unnamedRoot("subject"); - val childData = "child"; - val child = Nodes.unnamedChild(childData, node); - //when - val found = node.findOrCreateChild(childData); - //then - assertThat(found).as( - "when searching for a child by data, the matching child is " - + "found").isSameAs(child); - } - - /** - * Test that we create a missing child of a node. - */ - @Test - public void shouldFindCreateNewChildNode() { - //given - node = Nodes.unnamedRoot("subject"); - val childData = "child"; - //when - val found = node.findOrCreateChild(childData); - //then - assertThat(found.getData()).as( - "when searching for a non-existent child by data, a new node " - + "is created").contains(childData); - } - - /** - * Test that if we pass null we get an exception. - */ - @Test - public void findOrCreateChildShouldThrowNPEFWhenChildIsNull() { - //given - node = Nodes.unnamedRoot("subject"); - exception.expect(NullPointerException.class); - exception.expectMessage("child"); - //when - node.findOrCreateChild(null); - } - /** * Test that we can get the node for a child. */ diff --git a/src/test/java/net/kemitix/node/NodesTest.java b/src/test/java/net/kemitix/node/NodesTest.java index ace4f79..6c9aee4 100644 --- a/src/test/java/net/kemitix/node/NodesTest.java +++ b/src/test/java/net/kemitix/node/NodesTest.java @@ -24,7 +24,7 @@ public class NodesTest { val node = Nodes.unnamedRoot("data"); SoftAssertions softly = new SoftAssertions(); softly.assertThat(node.getData()).contains("data"); - softly.assertThat(node.getName()).isNull(); + softly.assertThat(node.getName()).isEmpty(); softly.assertAll(); } @@ -43,7 +43,7 @@ public class NodesTest { val node = Nodes.unnamedChild("data", parent); SoftAssertions softly = new SoftAssertions(); softly.assertThat(node.getData()).contains("data"); - softly.assertThat(node.getName()).isNull(); + softly.assertThat(node.getName()).isEmpty(); softly.assertThat(node.getParent()).contains(parent); softly.assertAll(); }