zhao.algorithmMagic.operands.coordinateNet.DoubleRouteNet Maven / Gradle / Ivy
package zhao.algorithmMagic.operands.coordinateNet;
import zhao.algorithmMagic.exception.OperatorOperationException;
import zhao.algorithmMagic.operands.coordinate.DoubleCoordinateMany;
import zhao.algorithmMagic.operands.route.DoubleConsanguinityRoute;
import java.util.*;
/**
* Java类于 2022/10/19 17:07:38 创建
*
* Double类型的多维线路网，存储的都是Double类型的多维线路对象，其中的每一个坐标维度可以是任意的，但是需要每一个坐标的维度数量保持一致！
*
* The Double-type multidimensional line network stores all Double-type multidimensional line objects. Each coordinate dimension can be arbitrary, but the number of dimensions of each coordinate needs to be consistent!
*
* @author zhao
*/
public class DoubleRouteNet implements RouteNet {
private final HashMap doubleConsanguinityRouteHashMap = new HashMap<>(0b1010);
private final HashMap doubleConsanguinityRouteHashMap_SubMark = new HashMap<>(0b1010);
private final HashMap doubleConsanguinityRouteHashMap_MasterTag = new HashMap<>();
/**
* 构造出来一张线路网
*
* construct a network of lines
*
* @param routeCollection 这张网中的所有线路
*
* All lines in this net
*/
private DoubleRouteNet(Collection routeCollection) {
for (DoubleConsanguinityRoute DoubleConsanguinityRoute : routeCollection) {
addRoute(DoubleConsanguinityRoute);
}
}
private DoubleRouteNet(Map map) {
this.doubleConsanguinityRouteHashMap.putAll(map);
}
/**
* 将一个double的二维线路网构建出来。
*
* A shaped two-dimensional line network is constructed.
*
* @param routeCollection 整个网络中所有的线路对象。
*
* All line objects in the entire network.
* @return double的二维线路网
*/
public static DoubleRouteNet parse(Collection routeCollection) {
return new DoubleRouteNet(routeCollection);
}
/**
* @param doubleConsanguinityRoute2DS 整个网络中所有的线路对象。
*
* All line objects in the entire network.
* @return Shaped 2D line network
*/
public static DoubleRouteNet parse(DoubleConsanguinityRoute... doubleConsanguinityRoute2DS) {
return new DoubleRouteNet(Arrays.asList(doubleConsanguinityRoute2DS));
}
/**
* 从普通集合中获取到一个路线对象。
*
* Get a route object from the normal collection.
*
* @param RouteName 路线对象的名称
*
* the name of the route object
* @return 路线对象
*
* route object
*/
public DoubleConsanguinityRoute getRouteFromHashMap(String RouteName) {
return this.doubleConsanguinityRouteHashMap.get(RouteName);
}
/**
* 从SubMark集合中获取到一个路线对象。
*
* Get a route object from the Sub Mark collection.
*
* @param RouteName 路线对象的名称
*
* the name of the route object
* @return 路线对象
*
* route object
*/
public DoubleConsanguinityRoute getRouteFromSubMark(String RouteName) {
return this.doubleConsanguinityRouteHashMap_SubMark.get(RouteName);
}
/**
* 从MasterTag集合中获取到一个路线对象。
*
* Get a route object from the Master Tag collection.
*
* Get a route object from the normal collection.
*
* @param RouteName 路线对象的名称
*
* the name of the route object
* @return 路线对象
*
* route object
*/
public DoubleConsanguinityRoute getRouteFromMasterTag(String RouteName) {
return this.doubleConsanguinityRouteHashMap_MasterTag.get(RouteName);
}
/**
* 将两个操作数进行求和的方法，具体用法请参阅API说明。
*
* The method for summing two operands, please refer to the API description for specific usage.
*
* @param value 被求和的参数 Parameters to be summed
* @return 求和之后的数值 the value after the sum
*
* 将两个网络中的每一个线路进行求和（不保证线路之间的顺序）
*
* Sums each line in both networks (order between lines is not guaranteed)
*/
@Override
public RouteNet add(RouteNet value) {
int routeCount1 = this.getRouteCount();
int routeCount2 = value.getRouteCount();
if (routeCount1 == routeCount2) {
Iterator iterator1 = this.getNetDataSet().iterator();
Iterator iterator2 = value.getNetDataSet().iterator();
ArrayList arrayList = new ArrayList<>();
while (iterator1.hasNext() && iterator2.hasNext()) {
arrayList.add(iterator1.next().add(iterator2.next()));
}
return DoubleRouteNet.parse(arrayList);
} else {
throw new OperatorOperationException("在 'IntegerRoute2DNet1 add IntegerRoute2DNet2' 的时候出现了错误，两个线路网中的线路数量不同，因此无法求和。\n" +
"There was an error when 'IntegerRoute2DNet1 add IntegerRoute2DNet2', the number of routes in the two route nets is different, so the sum cannot be done. \n" +
"Number of lines => IntegerRoute2DNet1[" + routeCount1 + "] IntegerRoute2DNet2[" + routeCount2 + "]");
}
}
/**
* 在两个操作数之间做差的方法，具体用法请参阅API说明。
*
* The method of making a difference between two operands, please refer to the API description for specific usage.
*
* @param value 被做差的参数（被减数） The parameter to be subtracted (minuend)
* @return 差异数值 difference value
*
* 将两个网络中的每一个线路进行做差（不保证线路之间的顺序）
*
* Diff each line in both networks (order between lines is not guaranteed)
*/
@Override
public RouteNet diff(RouteNet value) {
int routeCount1 = this.getRouteCount();
int routeCount2 = value.getRouteCount();
if (routeCount1 == routeCount2) {
Iterator iterator1 = this.getNetDataSet().iterator();
Iterator iterator2 = value.getNetDataSet().iterator();
ArrayList arrayList = new ArrayList<>();
while (iterator1.hasNext() && iterator2.hasNext()) {
arrayList.add(iterator1.next().diff(iterator2.next()));
}
return DoubleRouteNet.parse(arrayList);
} else {
throw new OperatorOperationException("在 'IntegerRoute2DNet1 add IntegerRoute2DNet2' 的时候出现了错误，两个线路网中的线路数量不同，因此无法求和。\n" +
"There was an error when 'IntegerRoute2DNet1 add IntegerRoute2DNet2', the number of routes in the two route nets is different, so the sum cannot be done. \n" +
"Number of lines => IntegerRoute2DNet1[" + routeCount1 + "] IntegerRoute2DNet2[" + routeCount2 + "]");
}
}
/**
* 判断一条线路是否存在于线路网中。
*
* Determines whether a line exists in the line network.
*
* @param RouteName 线路名称
*
* line name
* @return true代表在线路网中存在
*
* true means exists in the line network
*/
@Override
public boolean containsKeyFromRoute2DHashMap(String RouteName) {
return this.doubleConsanguinityRouteHashMap.containsKey(RouteName) || this.doubleConsanguinityRouteHashMap_SubMark.containsKey(RouteName) || this.doubleConsanguinityRouteHashMap_MasterTag.containsKey(RouteName);
}
/**
* @return 路线网络数据集，其中每一个元素都是一条路线
*/
@Override
public HashSet getNetDataSet() {
List arrayList = new ArrayList<>(this.doubleConsanguinityRouteHashMap.values());
arrayList.addAll(this.doubleConsanguinityRouteHashMap_SubMark.values());
arrayList.addAll(this.doubleConsanguinityRouteHashMap_MasterTag.values());
return new HashSet<>(arrayList);
}
/**
* @param doubleConsanguinityRoute 需要被添加的网络数据集
* @return 是否添加成功
*/
@Override
public boolean addRoute(DoubleConsanguinityRoute doubleConsanguinityRoute) {
this.doubleConsanguinityRouteHashMap.put(doubleConsanguinityRoute.getRouteName(), doubleConsanguinityRoute);
return true;
}
@Override
public int getRouteCount() {
return this.doubleConsanguinityRouteHashMap.size() + this.doubleConsanguinityRouteHashMap_SubMark.size() + this.doubleConsanguinityRouteHashMap_MasterTag.size();
}
/**
* 添加一条被标记的路线对象,该类实现了绘图集成器的第二般接口,因此该方法拓展出来了一个新功能就是标记路线,您可以在这个方法中添加标记路线.
*
* Add a marked route object, this class implements the second general interface of the drawing integrator, so this method extends a new function to mark the route, you can add the marked route in this method.
*
* @param doubleConsanguinityRoute 被标记的二维路线对象,该对象可以在绘图器中以特殊颜色绘制出来!
* A marked 2D route object that can be drawn in a special color in the plotter!
* 有关标记颜色的设置与获取, 请您调用"setSignColor"用于设置!默认是紫色
*
* For the setting and obtaining of the sign color, please call "set Sign Color" for viewing!
*/
public void addSubMarkRoute(DoubleConsanguinityRoute doubleConsanguinityRoute) {
String s = doubleConsanguinityRoute.getRouteName();
this.doubleConsanguinityRouteHashMap_SubMark.put(s, doubleConsanguinityRoute);
this.doubleConsanguinityRouteHashMap.remove(s);
this.doubleConsanguinityRouteHashMap_MasterTag.remove(s);
}
/**
* 添加一条被标记的路线对象,该类实现了绘图集成器的第二般接口,因此该方法拓展出来了一个新功能就是标记路线,您可以在这个方法中添加标记路线.
*
* Add a marked route object, this class implements the second general interface of the drawing integrator, so this method extends a new function to mark the route, you can add the marked route in this method.
*
* @param doubleConsanguinityRoute 被标记的二维路线对象,该对象可以在绘图器中以特殊颜色绘制出来!
* A marked 2D route object that can be drawn in a special color in the plotter!
* 有关标记颜色的设置与获取, 请您调用"setSignColor"用于设置!默认是紫色
*
* For the setting and obtaining of the sign color, please call "set Sign Color" for viewing!
*/
public void addMasterTagRoute(DoubleConsanguinityRoute doubleConsanguinityRoute) {
String s = doubleConsanguinityRoute.getRouteName();
this.doubleConsanguinityRouteHashMap_MasterTag.put(s, doubleConsanguinityRoute);
this.doubleConsanguinityRouteHashMap_SubMark.remove(s);
this.doubleConsanguinityRouteHashMap.remove(s);
}
public HashMap getDoubleConsanguinityRouteHashMap() {
return doubleConsanguinityRouteHashMap;
}
public HashMap getDoubleConsanguinityRouteHashMap_SubMark() {
return doubleConsanguinityRouteHashMap_SubMark;
}
public HashMap getDoubleConsanguinityRouteHashMap_MasterTag() {
return doubleConsanguinityRouteHashMap_MasterTag;
}
}