TypeCastGraph (type 0.1 API)

java.lang.Object
- xyz.cofe.collection.graph.SimpleSDGraph<Class,xyz.cofe.collection.Convertor<Object,Object>>
- - xyz.cofe.typeconv.TypeCastGraph

All Implemented Interfaces:

xyz.cofe.collection.graph.DirectedGraph, xyz.cofe.collection.graph.Graph<Class,xyz.cofe.collection.Convertor<Object,Object>>, xyz.cofe.collection.graph.SingleDirectedGraph<Class,xyz.cofe.collection.Convertor<Object,Object>>, xyz.cofe.collection.graph.SingleGraph<Class,xyz.cofe.collection.Convertor<Object,Object>>

Direct Known Subclasses:

BaseCastGraph
```
public class TypeCastGraph
extends xyz.cofe.collection.graph.SimpleSDGraph<Class,xyz.cofe.collection.Convertor<Object,Object>>
implements xyz.cofe.collection.graph.Graph<Class,xyz.cofe.collection.Convertor<Object,Object>>
```
Граф конвертирования типов.
В качестве вершин графа - Java тип

В качестве ребра графа - функция преобразования типа.
Ребро может быть взешенно (интерфейс GetWeight).

При преобразованиях подбирается кратчайший путь пробразования (GetWeight).

В процессе преобразования учитывается возможность автоматического приведения типа (конструкция assignable from) для начальной вершины в пути преобразования.

Author:

Kamnev Georgiy (nt.gocha@gmail.com)

Field Summary

Fields
Modifier and Type	Field and Description
`protected xyz.cofe.collection.set.ClassSet`	`classes`
`protected xyz.cofe.collection.Convertor<xyz.cofe.collection.graph.Edge<Class,xyz.cofe.collection.Convertor<Object,Object>>,Double>`	`edgeWeightConvertor`

Fields inherited from class xyz.cofe.collection.graph.SimpleSDGraph
edges, factory, nodes

Constructor Summary

Constructors
Constructor and Description

TypeCastGraph()
Конструктор по умолчанию

TypeCastGraph(TypeCastGraph src)
Конструктор копирования

Constructors
Constructor and Description
`TypeCastGraph()` Конструктор по умолчанию
`TypeCastGraph(TypeCastGraph src)` Конструктор копирования

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<TARGET> TARGET`	`cast(Object value, Class<TARGET> targetType)` Преборазования значения
`Object`	`cast(Object value, Class targetType, xyz.cofe.common.Reciver<SequenceCaster> newSeqCasters, xyz.cofe.common.Reciver<xyz.cofe.collection.Convertor<Object,Object>> castedConvertor, xyz.cofe.common.Reciver<xyz.cofe.collection.Pair<xyz.cofe.collection.Convertor<Object,Object>,Throwable>> failedCastConvertor)` Преборазования значения
`TypeCastGraph`	`clone()` Клонирование
`xyz.cofe.collection.Convertor<xyz.cofe.collection.graph.Edge<Class,xyz.cofe.collection.Convertor<Object,Object>>,Double>`	`createEdgeWeight()` Создание конвертора ребро графа -> вес
`SequenceCaster`	`createSequenceCaster(xyz.cofe.collection.graph.Path<Class,xyz.cofe.collection.Convertor<Object,Object>> path)` Создание Caster для цепочки преобразований
`xyz.cofe.collection.graph.Path<Class,xyz.cofe.collection.Convertor<Object,Object>>`	`findPath(Class from, Class to)` Поиск пути цепочки преобразований.
`xyz.cofe.collection.graph.Path<Class,xyz.cofe.collection.Convertor<Object,Object>>`	`findPath(Class from, Class to, xyz.cofe.collection.Predicate<xyz.cofe.collection.graph.Path<Class,xyz.cofe.collection.Convertor<Object,Object>>> filter)` Поиск пути цепочки преобразований.
`List<Class>`	`findStartNode(Class type, boolean strongCompare, boolean childToParent, boolean incParent, boolean incChildren)` Получение начального узла преобразований
`List<xyz.cofe.collection.graph.Path<Class,xyz.cofe.collection.Convertor<Object,Object>>>`	`getCastPaths(Class fromType, Class targetType)` Получение возможных путей преобразования
`xyz.cofe.collection.Convertor<xyz.cofe.collection.graph.Edge<Class,xyz.cofe.collection.Convertor<Object,Object>>,Double>`	`getEdgeWeight()` Получение конвертора ребра графа в его вес
`protected void`	`onNodeAdded(Class type)`
`protected void`	`onNodeRemoved(Class type)`

Methods inherited from class xyz.cofe.collection.graph.SimpleSDGraph
add, add, clearAll, clearEdges, contains, edgesOf, edgesOfNodeA, edgesOfNodeB, get, getEdge, getEdges, getEdges, getNodes, hasEdge, indexOf, onEdgeAdded, onEdgeRemoved, remove, remove, removeEdge, set, setEdge, setEdges

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface xyz.cofe.collection.graph.Graph
add, clearAll, clearEdges, contains, edgesOf, edgesOfNodeA, edgesOfNodeB, getEdge, getEdges, getEdges, getNodes, hasEdge, remove, removeEdge, setEdge, setEdges

- Field Detail
  - classes
```
protected xyz.cofe.collection.set.ClassSet classes
```
  - edgeWeightConvertor
```
protected xyz.cofe.collection.Convertor<xyz.cofe.collection.graph.Edge<Class,xyz.cofe.collection.Convertor<Object,Object>>,Double> edgeWeightConvertor
```
- Constructor Detail
  - TypeCastGraph
```
public TypeCastGraph()
```
    Конструктор по умолчанию
  - TypeCastGraph
```
public TypeCastGraph(TypeCastGraph src)
```
    Конструктор копирования
    
    Parameters:
    
    src - конструктор
- Method Detail
  - clone
```
public TypeCastGraph clone()
```
    Клонирование
    
    Overrides:
    
    clone in class Object
    
    Returns:
    
    клон
  - onNodeAdded
```
protected void onNodeAdded(Class type)
```
    Overrides:
    
    onNodeAdded in class xyz.cofe.collection.graph.SimpleSDGraph<Class,xyz.cofe.collection.Convertor<Object,Object>>
  - onNodeRemoved
```
protected void onNodeRemoved(Class type)
```
    Overrides:
    
    onNodeRemoved in class xyz.cofe.collection.graph.SimpleSDGraph<Class,xyz.cofe.collection.Convertor<Object,Object>>
  - findStartNode
```
public List<Class> findStartNode(Class type,
                                 boolean strongCompare,
                                 boolean childToParent,
                                 boolean incParent,
                                 boolean incChildren)
```
    Получение начального узла преобразований
    
    Parameters:
    
    type - Искомый тип
    
    strongCompare - true - жесткое сравнение типов; false - использование конструкции instanceof в сравнении
    
    childToParent - true - последовательность в порядке от дочерних классов, к родительскому классу
    false - обратная последовательность: в порядке от родительского класса к дочерним
    
    incParent - true - включать в поиск родитеслькие классы
    
    incChildren - true - включать в поиск дочерние классы
    
    Returns:
    
    Перечень классов удовлетворяющих критерию поиска
  - createEdgeWeight
```
public xyz.cofe.collection.Convertor<xyz.cofe.collection.graph.Edge<Class,xyz.cofe.collection.Convertor<Object,Object>>,Double> createEdgeWeight()
```
    Создание конвертора ребро графа -> вес
    
    Returns:
    
    конвертор ребр графа в их веса
  - getEdgeWeight
```
public xyz.cofe.collection.Convertor<xyz.cofe.collection.graph.Edge<Class,xyz.cofe.collection.Convertor<Object,Object>>,Double> getEdgeWeight()
```
    Получение конвертора ребра графа в его вес
    
    Returns:
    
    конвертор ребр графа в веса
  - findPath
```
public xyz.cofe.collection.graph.Path<Class,xyz.cofe.collection.Convertor<Object,Object>> findPath(Class from,
                                                                                                   Class to)
```
    Поиск пути цепочки преобразований. Возвращает наименьший по длине путь преобразования типа
    
    Parameters:
    
    from - класс начала пути преобразования
    
    to - конечный класс пути преобразования
    
    Returns:
    
    путь или null
  - findPath
```
public xyz.cofe.collection.graph.Path<Class,xyz.cofe.collection.Convertor<Object,Object>> findPath(Class from,
                                                                                                   Class to,
                                                                                                   xyz.cofe.collection.Predicate<xyz.cofe.collection.graph.Path<Class,xyz.cofe.collection.Convertor<Object,Object>>> filter)
```
    Поиск пути цепочки преобразований. Возвращает наименьший по длине путь преобразования типа
    
    Parameters:
    
    from - класс начала пути преобразования
    
    to - конечный класс пути преобразования
    
    filter - Фильтр или null
    
    Returns:
    
    путь или null
  - createSequenceCaster
```
public SequenceCaster createSequenceCaster(xyz.cofe.collection.graph.Path<Class,xyz.cofe.collection.Convertor<Object,Object>> path)
```
    Создание Caster для цепочки преобразований
    
    Parameters:
    
    path - цепочка преобразований
    
    Returns:
    
    caster
  - getCastPaths
```
public List<xyz.cofe.collection.graph.Path<Class,xyz.cofe.collection.Convertor<Object,Object>>> getCastPaths(Class fromType,
                                                                                                             Class targetType)
```
    Получение возможных путей преобразования
    
    Parameters:
    
    fromType - Исходный тип данных
    
    targetType - Конечный тип данных
    
    Returns:
    
    Цепочки преобразований
  - cast
```
public <TARGET> TARGET cast(Object value,
                            Class<TARGET> targetType)
```
    Преборазования значения
    
    Type Parameters:
    
    TARGET - Тип данных который хотим получить
    
    Parameters:
    
    value - Исходное значение
    
    targetType - Целевой тип
    
    Returns:
    
    Преобразованное значение
    
    Throws:
    
    Error - если невозможно преобразование
  - cast
```
public Object cast(Object value,
                   Class targetType,
                   xyz.cofe.common.Reciver<SequenceCaster> newSeqCasters,
                   xyz.cofe.common.Reciver<xyz.cofe.collection.Convertor<Object,Object>> castedConvertor,
                   xyz.cofe.common.Reciver<xyz.cofe.collection.Pair<xyz.cofe.collection.Convertor<Object,Object>,Throwable>> failedCastConvertor)
```
    Преборазования значения
    
    Parameters:
    
    value - Исходное значение
    
    targetType - Целевой тип
    
    newSeqCasters - Созданные SequenceCaster
    
    castedConvertor - Convertor который удачно отработал
    
    failedCastConvertor - Convertor который не удачно отработал
    
    Returns:
    
    Преобразованное значение
    
    Throws:
    
    Error - если невозможно преобразование

Class TypeCastGraph

Field Summary

Fields inherited from class xyz.cofe.collection.graph.SimpleSDGraph

Constructor Summary

Method Summary

Methods inherited from class xyz.cofe.collection.graph.SimpleSDGraph

Methods inherited from class java.lang.Object

Methods inherited from interface xyz.cofe.collection.graph.Graph

Field Detail

classes

edgeWeightConvertor

Constructor Detail

TypeCastGraph

TypeCastGraph

Method Detail

clone

onNodeAdded

onNodeRemoved

findStartNode

createEdgeWeight

getEdgeWeight

findPath

findPath

createSequenceCaster

getCastPaths

cast

cast