Add examples, new getAll method and fix pack storing.

Author: KennyProgrammer

src/kenny/jecs/BaseJECS.java renamed to src/com/kenny/jecs/BaseJECS.java

@@ -1,6 +1,6 @@
-package kenny.jecs;
+package com.kenny.jecs;
 
-import static kenny.jecs.BaseJECS.Reflect.*;
+import static com.kenny.jecs.BaseJECS.Reflect.*;
 import static java.lang.annotation.ElementType.*;
 import static java.lang.annotation.RetentionPolicy.*;
 import java.lang.annotation.Documented;
@@ -28,28 +28,28 @@
 import java.util.concurrent.ThreadLocalRandom;
 import java.util.Map.Entry;
 
-import kenny.jecs.collection.ComponentSequence;
-import kenny.jecs.collection.ComponentSequenceImpl;
-import kenny.jecs.collection.Pair;
-import kenny.jecs.collection.RawPair;
-import kenny.jecs.collection.ReversedIterator;
-import kenny.jecs.collection.ReversedIteratorList;
-import kenny.jecs.funcs.Create;
-import kenny.jecs.funcs.ICreate;
-import kenny.jecs.funcs.Destroy;
-import kenny.jecs.funcs.IDestroy;
-import kenny.jecs.funcs.Each;
-import kenny.jecs.funcs.EachC;
-import kenny.jecs.funcs.IEachC;
-import kenny.jecs.funcs.EachE;
-import kenny.jecs.funcs.IEachE;
-import kenny.jecs.funcs.IEach;
-import kenny.jecs.funcs.Patch;
-import kenny.jecs.funcs.IPatch;
-import kenny.jecs.funcs.Sort;
-import kenny.jecs.funcs.SortC;
-import kenny.jecs.funcs.ISort;
-import kenny.jecs.funcs.ISortC;
+import com.kenny.jecs.collection.ComponentSequence;
+import com.kenny.jecs.collection.ComponentSequenceImpl;
+import com.kenny.jecs.collection.Pair;
+import com.kenny.jecs.collection.RawPair;
+import com.kenny.jecs.collection.ReversedIterator;
+import com.kenny.jecs.collection.ReversedIteratorList;
+import com.kenny.jecs.funcs.Create;
+import com.kenny.jecs.funcs.ICreate;
+import com.kenny.jecs.funcs.Destroy;
+import com.kenny.jecs.funcs.IDestroy;
+import com.kenny.jecs.funcs.Each;
+import com.kenny.jecs.funcs.EachC;
+import com.kenny.jecs.funcs.IEachC;
+import com.kenny.jecs.funcs.EachE;
+import com.kenny.jecs.funcs.IEachE;
+import com.kenny.jecs.funcs.IEach;
+import com.kenny.jecs.funcs.Patch;
+import com.kenny.jecs.funcs.IPatch;
+import com.kenny.jecs.funcs.Sort;
+import com.kenny.jecs.funcs.SortC;
+import com.kenny.jecs.funcs.ISort;
+import com.kenny.jecs.funcs.ISortC;
 
 /**
  * <code>JECS</code> or <b>Java Entity-Component-System API</b> this is a small system that holds all entity identifiers in a single object 
@@ -541,22 +541,41 @@ public <C> C get(EntityT entity, Class<C> componentT) {
 		}
 
 		/**
-		 * See {@link #BaseJECS.get(Number, Class...)}
+		 * Pair components. See {@link #BaseJECS.getPair(Number, Class, Class)}
 		 */
-		@SuppressWarnings("unchecked")
 		@JECSApi(since = "0.1.9")
-		public <C extends Component> C[] get(EntityT entity, Class<C>... componentTs) {
-			return system.get(entity, componentTs);
+		public <C extends Component, C1 extends Component> 
+			Pair<C, C1> getPair(EntityT entity, Class<C> a, Class<C1> b) {
+			return system.getPair(entity, a, b);
 		}
 
 		/**
-		 * See {@link #BaseJECS.getPair(Number, Class, Class)}
+		 * Two components. See {@link #BaseJECS.getPair(Number, Class, Class)}
 		 */
 		@JECSApi(since = "0.1.9")
 		public <C extends Component, C1 extends Component> 
-			Pair<C, C1> getPair(EntityT entity, Class<C> a, Class<C1> b) {
-			return system.getPair(entity, a, b);
+			C[] get(EntityT entity, Class<C> a, Class<C1> b) {
+			return system.get(entity, a, b);
+		}
+		
+		/**
+		 * Three components. See {@link #BaseJECS.get(Number, Class...)}
+		 */
+		@JECSApi(since = "0.1.9")
+		public <C extends Component, C1 extends Component, C2 extends Component> 
+			C[] get(EntityT entity, Class<C> a, Class<C1> b, Class<C2> c) {
+			return system.get(entity, a, b ,c);
+		}
+		
+		/**
+		 * Four components. See {@link #BaseJECS.get(Number, Class...)}
+		 */
+		@JECSApi(since = "0.1.9")
+		public <C extends Component, C1 extends Component, C2 extends Component, C3 extends Component> 
+			C[] get(EntityT entity, Class<C> a, Class<C1> b, Class<C2> c, Class<C3> d) {
+			return system.get(entity, a, b, c, d);
 		}
+		
 
 		@Override
 		public Iterator<EntityT> iterator() {
@@ -618,6 +637,8 @@ public Iterator<EntityT> iterator() {
 	View<EntityT>                                         view = new View<>(this);
 	/**Temparary component array stored by #push and released by #pop.*/
 	Object[]                                              arr = null;
+	/** Global pack index. */
+	int                                                   packIndex = 0;
 
 	/**Just null is already exist + im love C++.*/
 	@JECSApi
@@ -1472,7 +1493,7 @@ else if(args[0] == NULL_ARGS)
 			Constructor<?> ctor = componentT.getDeclaredConstructors()[0];
 			ctor.setAccessible(true);
 			if(isInnerClass && !isInnerStaticClass) {
-				Object[] argss = getInnerObjects(args, finalCtorArgs, isNullArgs);
+				Object[] argss = getInnerObjects(args, finalCtorArgs, isNullArgs);;
 				return (C) ctor.newInstance(argss);
 			} else 
 				return (C) ctor.newInstance((Object[])null);
@@ -1518,7 +1539,7 @@ private Object[] getInnerObjects(Object[] args, Class<?>[] finalCtorArgs, boolea
 				argss[i] = args[i - 1];
 		} else {
 			argss = new Object[1];
-			args[0] = inner;
+			argss[0] = inner;
 		}
 		return argss;
 	}
@@ -2946,6 +2967,33 @@ public <C extends Component> EntityT get(Class<C> component) {
 
 		return null;
 	}
+	
+	/**
+	 * Gets all entities that attached to this  component.
+	 * <p>
+	 * If this method was called by constructor of some component on intitializaion or emplacing 
+	 * this also returns current emplaced entity or entity that will be emplaced, with this point of
+	 * view is should be safe.
+	 * 
+	 * @param <C> - component type.
+	 * @param component - Class type of component.
+	 */
+	@JECSApi(since = "0.1.9")
+	public <C extends Component> List<EntityT> getAll(Class<C> component) {
+		var pairs = pool.get(component);
+		if(pairs == null) 
+			return null;
+		
+		List<EntityT> ne = new ArrayList<EntityT>();
+		for(var entity : entities) {
+			for(Pair<EntityT, Component> pair : pairs) {
+				if(pair.first == entity)
+					ne.add(entity);
+			}
+		}
+	
+		return ne;
+	}
 
 	/**
 	 * Return next avaliable component object of entity from index.
@@ -3106,22 +3154,21 @@ public <C extends Component> C getIfFamily(EntityT entity, Class<? extends Compo
 	@SafeVarargs
 	@JECSApi(since = "0.1.4")
 	public final <C extends Component> void createPack(EntityT entity, Class<? extends Component>... componentTs) {
-		for(int i = 0; i < packs.size(); i++) {
-			ComponentSequence<Component> sequence = packs.get(i); 
-			if(sequence == null)
-				sequence = packs.put(i, new ComponentSequenceImpl<Component>());
-				
-			if(sequence.isEmpty()) {
-				try {
-					Component[] component = get(entity, componentTs);
-					for(int c = 0; c < component.length; c++)
-						sequence.add(component[c]); 
-					return;
-				} catch (JECSException e) { e.printStackTrace(); }	
-			}
-			else 
-				continue;
+	
+		ComponentSequence<Component> sequence = new ComponentSequenceImpl<Component>();
+
+		if(sequence.isEmpty()) {
+			try {
+				Component[] component = get(entity, componentTs);
+				for(int c = 0; c < component.length; c++)
+					sequence.add(component[c]); 
+				packs.put(packIndex, sequence);
+			} catch (JECSException e) { e.printStackTrace(); }	
+		} else {
+			createPack(entity, componentTs);
 		}
+		
+		packIndex++;
 	}
 
 	/**

src/kenny/jecs/JECSException.java renamed to src/com/kenny/jecs/JECSException.java

@@ -1,4 +1,4 @@
-package kenny.jecs;
+package com.kenny.jecs;
 
 public class JECSException extends RuntimeException
 {

src/kenny/jecs/JECSUndifiendBehaviourError.java renamed to src/com/kenny/jecs/JECSUndifiendBehaviourError.java

@@ -1,4 +1,4 @@
-package kenny.jecs;
+package com.kenny.jecs;
 
 public class JECSUndifiendBehaviourError extends RuntimeException
 {

src/kenny/jecs/collection/ComponentSequence.java renamed to src/com/kenny/jecs/collection/ComponentSequence.java

@@ -1,4 +1,4 @@
-package kenny.jecs.collection;
+package com.kenny.jecs.collection;
 
 import java.util.List;
 

src/kenny/jecs/collection/ComponentSequenceImpl.java renamed to src/com/kenny/jecs/collection/ComponentSequenceImpl.java

@@ -1,4 +1,4 @@
-package kenny.jecs.collection;
+package com.kenny.jecs.collection;
 
 import java.util.ArrayList;
 import java.util.Collection;

src/kenny/jecs/collection/EntityContainer.java renamed to src/com/kenny/jecs/collection/EntityContainer.java

@@ -1,4 +1,4 @@
-package kenny.jecs.collection;
+package com.kenny.jecs.collection;
 
 import java.util.Map;
 

src/kenny/jecs/collection/EntityContainerImpl.java renamed to src/com/kenny/jecs/collection/EntityContainerImpl.java

@@ -1,4 +1,4 @@
-package kenny.jecs.collection;
+package com.kenny.jecs.collection;
 
 import java.io.Serializable;
 import java.util.Iterator;

src/kenny/jecs/collection/Pair.java renamed to src/com/kenny/jecs/collection/Pair.java

@@ -1,6 +1,8 @@
-package kenny.jecs.collection;
-
+package com.kenny.jecs.collection;
 
+/**
+ * Pair is container/collection type that can hold two objects with different types.
+ */
 public class Pair<A, B> implements Comparable<A>
 {
 	public A first;
@@ -31,23 +33,21 @@ public void setSecond(B second) {
 		this.second = second;
 	}
 
-	//@Override
-	//public Iterator<A> iterator() {
-	//	return null;
-	//}
-	//
-	//public Iterator<B> iteratorB() {
-	//	return null;
-	//}////
-
 	@Override
 	public String toString() {
 		return "[" + first + ", " + second + "]";
 	}
 
 	@Override
 	public int compareTo(A o) {
-		// TODO Auto-generated method stub
+		if(o == this || o.getClass() == o.getClass())
+			return 1;
+		
+		@SuppressWarnings("unchecked")
+		B b = (B) new Object();
+		if(b.getClass() == o.getClass() || b.getClass() == this.getClass())
+			return 1;
+		
 		return 0;
 	}
 

src/kenny/jecs/collection/RawPair.java renamed to src/com/kenny/jecs/collection/RawPair.java

@@ -1,4 +1,4 @@
-package kenny.jecs.collection;
+package com.kenny.jecs.collection;
 
 /**
  * Non generic version of {@link Pair}.

src/kenny/jecs/collection/ReversedIterator.java renamed to src/com/kenny/jecs/collection/ReversedIterator.java

@@ -1,4 +1,4 @@
-package kenny.jecs.collection;
+package com.kenny.jecs.collection;
 
 import java.util.Iterator;
 import java.util.List;