[shrinkwrap-issues] [JBoss JIRA] Created: (SHRINKWRAP-236) Introduce Asset criteria to find contents in archive

[Dan Allen (JIRA)]

Introduce Asset criteria to find contents in archive 
-----------------------------------------------------

                 Key: SHRINKWRAP-236
                 URL: https://jira.jboss.org/browse/SHRINKWRAP-236
             Project: ShrinkWrap
          Issue Type: Feature Request
          Components: api, impl-base
    Affects Versions: 1.0.0-alpha-11
            Reporter: Dan Allen


The read capabilities on Archive are largely inadequate. You can get the content by an archive path or you can flip through all the content and filter the results by path name. However, there are much more logical structures inside the archive that ShrinkWrap does not expose an API to locate. For instance, I want to pull out one or more WebModules from an EnterpriseArchive.

However, if we were to introduce a closed set of read methods, the user would eventual outgrow them and find themselves in the same position. My recommendation is to follow the lead of Weld Extensions and use an Archive criteria API. I believe it's a good choice because it feels familiar to Java EE developers with it's JPA-like syntax and it's completely extensible. 

For example:

ArchiveContentQuery<EnterpriseArchive> query = ArchiveContentQueries.<EnterpriseArchive>createQuery(EnterpriseArchive.class)
      .addCriteria(new TypedAssetCriteria(WebArchive.class));
List<WebArchive> wars = query.getResuiltList();

This is so much simpler than using a filter on a tree walker. It's also crucial for manipulation of the Archive within Arquillian.

see http://docs.jboss.org/weld/extensions/reference/latest/en-US/html/properties.html#d0e917

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: https://jira.jboss.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira