Ant风格URL

左手的ㄟ右手 2024-03-27 17:10 20阅读 0赞

## 1 Ant 通配符 ##

Apache Ant 样式的路径有三种通配符匹配方法，利用它们可以组合出多种路径模式：

<table> 
 <thead> 
  <tr> 
   <th>通配符</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>?</td> 
   <td>匹配任何单字符</td> 
  </tr> 
  <tr> 
   <td>*</td> 
   <td>匹配0或者任意数量的字符</td> 
  </tr> 
  <tr> 
   <td>**</td> 
   <td>匹配0或者更多的目录</td> 
  </tr> 
 </tbody> 
</table>

## 2 匹配路径示例 ##

<table> 
 <thead> 
  <tr> 
   <th>URL路径</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>/app/*.x</td> 
   <td>匹配(Matches)所有在app路径下的.x文件</td> 
  </tr> 
  <tr> 
   <td>/app/p?ttern</td> 
   <td>匹配(Matches) /app/pattern 和 /app/pXttern,但是不包括/app/pttern</td> 
  </tr> 
  <tr> 
   <td>/**/example</td> 
   <td>匹配(Matches) /app/example, /app/foo/example, 和 /example</td> 
  </tr> 
  <tr> 
   <td>/app/**/dir/file.*</td> 
   <td>匹配(Matches) /app/dir/file.jsp, /app/foo/dir/file.html,/app/foo/bar/dir/file.pdf, 和 /app/dir/file.java</td> 
  </tr> 
  <tr> 
   <td>/**/*.jsp</td> 
   <td>匹配(Matches)任何的.jsp 文件</td> 
  </tr> 
 </tbody> 
</table>

需要注意的是，路径匹配**遵循最长匹配原则(has more characters)**，例如`/app/dir/file.jsp`符合`/**/*.jsp`和`/app/dir/*.jsp`两个路径模式，那么最终就是根据后者来匹配。

## 3 检测字符串是否为 Ant 风格 URL ##

### 3.1 基本规则 ###

<table> 
 <thead> 
  <tr> 
   <th>序号</th> 
   <th>规则</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1</td> 
   <td>必须以 <code>/</code>开头</td> 
   <td>该规则的检测已用正则实现</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>必须不以 <code>/</code>结尾</td> 
   <td>该规则的检测已用正则实现</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>任意两个 <code>/</code>不能相连</td> 
   <td>例如，不允许出现 <code>//abc</code>的形式；该规则的检测已用正则实现</td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td>必须使用 <strong>RFC3986 文档</strong>规定的符号</td> 
   <td>该规则的检测已用正则实现</td> 
  </tr> 
  <tr> 
   <td>5</td> 
   <td>在<strong>一节</strong>中，可以同时出现 <code>*</code>和 <code>?</code>，但<strong>不推荐</strong> <code>* </code>和 <code>?</code>连用</td> 
   <td>例如，<code>/*??b</code>等同于 <code>/*b</code>，显然后面的形式更简单</td> 
  </tr> 
  <tr> 
   <td>6</td> 
   <td>在<strong>一节</strong>中，可以<strong>出现</strong>或<strong>连续出现</strong> [0-n] 个<code>?</code></td> 
   <td>例如，<code>/a??b</code>，将匹配<code>/a11b</code>，但不匹配<code>/a1b</code></td> 
  </tr> 
  <tr> 
   <td>7</td> 
   <td>在<strong>一节</strong>中，可以<strong>出现</strong> [0-n] 个<code>*</code></td> 
   <td>例如，<code>/*a*b</code>，将匹配<code>/1a2b</code></td> 
  </tr> 
  <tr> 
   <td>8</td> 
   <td>在<strong>一节</strong>中，如果出现了 2 个 <code>*</code>，则该节<strong>不推荐</strong>存在任何其它字符</td> 
   <td>例如，<strong>不推荐</strong>出现 <code>/a/**b/b</code>的形式，<strong>推荐</strong> <code>/a/**/b</code>的形式，原因见下一规则；该规则的检测在前端中使用 JavaScript 实现</td> 
  </tr> 
  <tr> 
   <td>9</td> 
   <td>在<strong>一节</strong>中，<strong>连续出现</strong>[2,n] 个 <code>* </code>和其它字符，效果等同于只使用 1 个 <code>*</code></td> 
   <td>经过试验，连续出现 2 个及以上的 <code>*</code>时的效果等同于只使用 1 个 <code>*</code>，例如<code>/**a/b</code>等同于<code>/*a/b</code></td> 
  </tr> 
 </tbody> 
</table>

**\*RFC3986 介绍**：见外部网站：网址URL中特殊字符转义编码 https://blog.csdn.net/p312011150/article/details/78928003

**\*\*一节**：以 `/`开头到下一个 `/`之前的字符串，如 `/abc/def`中 `abc`为一节，`def`为一节

### 3.2 JavaScript 正则检测规则 ###

JS脚本：

var pattern = /^(\/[A-Za-z0-9*?#._~:@!$&'+,;%=\-\[\]]+)(\/[A-Za-z0-9*?#._~:@!$&'+,;%=\-\[\]]+)*$/g
     pattern.test();

## 4 在 Java 中检测是否匹配 Ant URL ##

public class AntPathMatcherTest {
        
    
    	private AntPathMatcher pathMatcher = new AntPathMatcher();
    
    	@Test
    	public void test() {
        
    		pathMatcher.setCachePatterns(true);
    		pathMatcher.setCaseSensitive(true);
    		pathMatcher.setTrimTokens(true);
    		pathMatcher.setPathSeparator("/");
    
    		Assert.assertTrue(pathMatcher.match("/*", "/test"));
    		Assert.assertTrue(pathMatcher.match("/test*/**/tt", "/test1/t/b/tt"));
    		Assert.assertTrue(pathMatcher.match("/*/*", "/test/test"));
    	}
    }