162

What are the rules for Ant path style patterns.

The Ant site itself is surprisingly uninformative.

1

5 Answers 5

218

Ant-style path patterns matching in :

The mapping matches URLs using the following rules:

  • ? matches one character
  • * matches zero or more characters
  • ** matches zero or more 'directories' in a path
  • {spring:[a-z]+} matches the regexp [a-z]+ as a path variable named "spring"

Some examples:

  • com/t?st.jsp - matches com/test.jsp but also com/tast.jsp or com/txst.jsp
  • com/*.jsp - matches all .jsp files in the com directory
  • com/**/test.jsp - matches all test.jsp files underneath the com path
  • org/springframework/**/*.jsp - matches all .jsp files underneath the org/springframework path
  • org/**/servlet/bla.jsp - matches org/springframework/servlet/bla.jsp but also org/springframework/testing/servlet/bla.jsp and org/servlet/bla.jsp
  • com/{filename:\\w+}.jsp will match com/test.jsp and assign the value test to the filename variable

http://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/util/AntPathMatcher.html

5
  • 34
    is there any way to match multiple patterns within one ant expression? like /com/*, /com/**/test.jsp in the same expression?
    – chrismarx
    Commented Oct 12, 2015 at 14:57
  • This pattern /WEB-INF/tiles-config/*-tiles-definition.xml to take all the files ends with -tiles-definition.xml is not working for me but at the same time /WEB-INF/tiles-config/*.xml works. So is * matches zero or more characters correct?
    – Khader M A
    Commented Oct 3, 2016 at 12:04
  • the explanation within the spring-framework-reference nicely puts it into a context: https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html#mvc-ann-requestmapping-uri-templates.
    – Wolfson
    Commented May 15, 2020 at 12:48
  • @chrismarx The comma separated syntax in your example works in Jenkins create-zip-file step which also uses Ant-style pattern to specify its globs.
    – lfree
    Commented Aug 24, 2021 at 7:26
  • In addition, you can use {*varname} to match zero or more directories and assign that to the varname variable (though this seems to be specific to Spring) Commented Dec 8, 2021 at 16:57
47

I suppose you mean how to use path patterns

If it is about whether to use slashes or backslashes these will be translated to path-separators on the platform used during execution-time.

1
  • 1
    +1. As an addition, here is how to navigating to this part of documentation from the Ant Manual: Table of Contents => "Concepts and Types" => [List of Types] left menu section => "Directory-based Tasks" => [Patterns] page section. Commented Feb 25, 2014 at 14:55
14

Most upvoted answer by @user11153 using tables for a more readable format.


The mapping matches URLs using the following rules:

+-----------------+---------------------------------------------------------+
| Wildcard        |            Description                                  |
+-----------------+---------------------------------------------------------+
| ?               | Matches exactly one character.                          |
| *               | Matches zero or more characters.                        |
| **              | Matches zero or more 'directories' in a path            |
| {spring:[a-z]+} | Matches regExp [a-z]+ as a path variable named "spring" |
+-----------------+---------------------------------------------------------+

Some examples:

+------------------------------+--------------------------------------------------------+
| Example                      | Matches:                                               |
+------------------------------+--------------------------------------------------------+
| com/t?st.jsp                 | com/test.jsp but also com/tast.jsp or com/txst.jsp     |
| com/*.jsp                    | All .jsp files in the com directory                    |
| com/**/test.jsp              | All test.jsp files underneath the com path             |
| org/springframework/**/*.jsp | All .jsp files underneath the org/springframework path |
| org/**/servlet/bla.jsp       | org/springframework/servlet/bla.jsp                    |
|                       also:  | org/springframework/testing/servlet/bla.jsp            |
|                       also:  | org/servlet/bla.jsp                                    |
| com/{filename:\\w+}.jsp      | com/test.jsp & assign value test to filename variable  |
+------------------------------+--------------------------------------------------------+
9

ANT Style Pattern Matcher

Wildcards

The utility uses three different wildcards.

+----------+-----------------------------------+
| Wildcard |            Description            |
+----------+-----------------------------------+
| *        | Matches zero or more characters.  |
| ?        | Matches exactly one character.    |
| **       | Matches zero or more directories. |
+----------+-----------------------------------+
2

As @user11153 mentioned, Spring's AntPathMatcher implements and documents the basics of Ant-style path pattern matching.

In addition, Java 7's nio APIs added some built in support for basic pattern matching via FileSystem.getPathMatcher

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.