001// License: GPL. For details, see LICENSE file. 002package org.openstreetmap.josm.data.osm; 003 004/** 005 * A segment consisting of two consecutive nodes out of a way. 006 */ 007public final class WaySegment extends IWaySegment<Node, Way> { 008 009 /** 010 * Constructs a new {@code IWaySegment}. 011 * 012 * @param way The way 013 * @param i The node lower index 014 * @throws IllegalArgumentException in case of invalid index 015 */ 016 public WaySegment(Way way, int i) { 017 super(way, i); 018 } 019 020 /** 021 * Determines and returns the way segment for the given way and node pair. You should prefer 022 * {@link IWaySegment#forNodePair(IWay, INode, INode)} whenever possible. 023 * 024 * @param way way 025 * @param first first node 026 * @param second second node 027 * @return way segment 028 * @throws IllegalArgumentException if the node pair is not single a segment of the way 029 */ 030 public static WaySegment forNodePair(Way way, Node first, Node second) { 031 int endIndex = way.getNodesCount() - 1; 032 while (endIndex > 0) { 033 final int indexOfFirst = way.getNodes().subList(0, endIndex).lastIndexOf(first); 034 if (indexOfFirst < 0) 035 break; 036 if (second.equals(way.getNode(indexOfFirst + 1))) { 037 return new WaySegment(way, indexOfFirst); 038 } 039 endIndex--; 040 } 041 throw new IllegalArgumentException(IWaySegment.NOT_A_SEGMENT); 042 } 043 044 /** 045 * Returns this way segment as complete way. 046 * @return the way segment as {@code Way} 047 */ 048 @Override 049 public Way toWay() { 050 Way w = new Way(); 051 w.addNode(getFirstNode()); 052 w.addNode(getSecondNode()); 053 return w; 054 } 055 056 @Override 057 public String toString() { 058 return "WaySegment [way=" + getWay().getUniqueId() + ", lowerIndex=" + getLowerIndex() + ']'; 059 } 060}