Extensible Component Scanner Files

eXtcos 0.2.1b - Release Notes
===========================

Notes
=====

This is a bugfix release. It fixes the issue of a NullPointerException being thrown
when all classes on the classpath are to be returned and none are to be stored with:
select().from("some.package").returning(all()).

Included files
==============
change_notes.txt
This file containing the change and release notes.

extcos-0.2.1b.jar
The binary release requiring additional dependencies to be present to work.

extcos-0.2.1b-all.jar
The standalone binary release requiring no additional dependencies to be present to work.

extcos-0.2.1b-all-osgi.jar
The standalone binary release to be used within OSGi environments.

extcos-0.2.1b-sources.zip
The sources of this release.

Dependencies
============

No changes made. Refer to older release and change notes, or use standalone distribution.

User manual
===========

No changes made. Refer to extcos-0.2b-userManual.pdf.


-------------------------------------------------------------------------------
Older release and change notes
-------------------------------------------------------------------------------

eXtcos 0.2b - Release Notes
===========================

Notes
=====

This is the second beta testing release. Its introducing major changes in the API as what
were the ClasspathScanner and ClassQuery classes are now the ComponentScanner and
ComponentQuery classes. This is to make things consistent and take away the focus from
the classpath and put it solely on the component.

Furthermore this release introduces the long awaited user manual describing all the
details about the extensible component scanner.


Included files
==============
change_notes.txt
This file containing the change and release notes.

extcos-0.2b.jar
The binary release requiring additional dependencies to be present to work.

extcos-0.2b-all.jar
The standalone binary release requiring no additional dependencies to be present to work.

extcos-0.2b-all-osgi.jar
The standalone binary release to be used within OSGi environments.

extcos-0.2b-sources.zip
The sources of this release.

extcos-0.2b-userManual.pdf
The user manual for this release.

Dependencies
============

No changes made. Refer to older release and change notes, or use standalone distribution.


eXtcos 0.1.2b - Change Notes
============================

Enhancements
============

Added support for finding classes in the JBoss Virtual File System. This is
based on the solution found in Spring Core 3.0.3 and works for both JBoss 5.x
and JBoss 6.x.

Dependencies
============

If you want to use eXtcos in an OSGi environment (e.g. JBoss) you can't use the normal
Google Guice distribution. Rather you need to use the patched version from Sonatype. You
can get it here: http://repo2.maven.org/maven2/org/sonatype/spice/inject/guice-patches/2.1.3/.
However you might actually find it easier to just use the standalone version of
eXtcos for OSGi integrating the patched version of Guice.

Standalone binaries
===================

This release includes a standalone binary release for standard use and for use
within an OSGi environment. Use the extcos-0.1.2b-all.jar file for standard and
the extcos-0.1.2b-all-osgi.jar file for OSGi environments to have extcos working
right out of the box.

Notes
=====

This is another sub-minor release on the way to release 0.2b. It includes the
binary and the source distribution file of eXtcos, along with the aforementioned
standalone binaries.


eXtcos 0.1.1b - Change Notes
============================

Fixes
=====

Problem with finding annotations on classes with several annotations solved


Enhancements
============

Implemented support for inherited annotations


Notes
=====

This sub-minor release only updates the binary distribution file of eXtcos.
This is due to the fact, that several other changes have been made to the
code base. However these changes will be released with release 0.2b along with
a comprehensive user documentation.


eXtcos 0.1b - Release Notes
===========================

This is a first release of the eXtcos framework.
It is provided for the sole purpose of beta testing
and released under the Apache V2 licence.


Included Files
==============

extcos-0.1b.jar
This is the binary release. You may use this as a dependency for
other projects. For testing purposes create a new project in your
favorite IDE and add this file to your build path.

extcos-0.1b-testsources.jar
This archive contains the sources of all the current tests and
test resources. You may use this as a starting point to get a
feel for the way to work with eXtcos and to create your own
tests.

extcos-0.1b-eclipseproject.jar
This archive contains the whole eclipse project and is a source
only release. Please only use this for testing purposes. Please
do NOT use this for further development. Instead contact me at
mimarox@users.sourceforge.net to be listed as a project member
and check out the project from SVN at
https://extcos.svn.sourceforge.net/svnroot/extcos/trunk if you
want to join the developer team.


Dependencies
============

Google Guice 2.0
Apache Commons Logging 1.1.1
ASM all 3.2

Please make sure you got those on your build path.
As to not waste storage they are not included in the eXtcos project files.


Usage
=====

Using eXtcos you can scan for classes of arbitrary packages that
have some super class, implement some interface or are annotated
with some annotation.

The easiest way to get started is using the following listing:

ClasspathScanner scanner = new ClasspathScanner();

Set<Class<?>> classes = scanner.getClasses(new ClassQuery() {
	protected void query() {
		select().
		from("my.test.package").
		returning(allImplementing(SomeInterface.class));
	}
});

With this you'd get all the classes from the package my.test.package
and all subpackages thereof implementing the SomeInterface interface.


Samples
=======

If you want to get a look at some code testing the library get the
extcos-0.1b-testsources.jar file and take a look at the
systemtests.ClasspathScannerTest test class included in the
src/test/java source folder.


Questions
=========

In case of questions regarding the testing phase or eXtcos in general
please contact me at mimarox@users.sourceforge.net.

Happy testing! :-)