29. Araxis Merge File Comparison Report

Produced by Araxis Merge on 11/20/2017 2:16:17 PM GMT Standard Time. See www.araxis.com for information about Merge. This report uses XHTML and CSS2, and is best viewed with a modern standards-compliant browser. For optimum results when printing this report, use landscape orientation and enable printing of background images and colours in your browser.

29.1 Files compared

# Location File Last Modified
1 C:\Merge Test Files\8.0.47\java\org\apache\catalina\comet CometFilter.java Fri Sep 29 16:53:28 2017 UTC
2 Mon Nov 20 14:16:17 2017 UTC

29.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 0 0
Changed 0 0
Inserted 0 0
Removed 1 81

29.3 Comparison options

Whitespace Consecutive whitespace is treated as a single space
Character case Differences in character case are significant
Line endings Differences in line endings (CR and LF characters) are ignored
CR/LF characters Not shown in the comparison detail

29.4 Active regular expressions

No regular expressions were active.

29.5 Comparison detail

1   /*        
2    * License d to the A pache Soft ware Found ation (ASF ) under on e or more        
3    * contrib utor licen se agreeme nts.  See  the NOTICE  file dist ributed wi th        
4    * this wo rk for add itional in formation  regarding  copyright  ownership.        
5    * The ASF  licenses  this file  to You und er the Apa che Licens e, Version  2.0        
6    * (the "L icense");  you may no t use this  file exce pt in comp liance wit h        
7    * the Lic ense.  You  may obtai n a copy o f the Lice nse at        
8    *        
9    *      ht tp://www.a pache.org/ licenses/L ICENSE-2.0        
10    *        
11    * Unless  required b y applicab le law or  agreed to  in writing , software        
12    * distrib uted under  the Licen se is dist ributed on  an "AS IS " BASIS,        
13    * WITHOUT  WARRANTIE S OR CONDI TIONS OF A NY KIND, e ither expr ess or imp lied.        
14    * See the  License f or the spe cific lang uage gover ning permi ssions and        
15    * limitat ions under  the Licen se.        
16    */        
17          
18          
19   package or g.apache.c atalina.co met;        
20          
21   import jav a.io.IOExc eption;        
22          
23   import jav ax.servlet .Filter;        
24   import jav ax.servlet .ServletEx ception;        
25          
26   /**        
27    * A Comet  filter, s imilar to  regular fi lters, per forms filt ering task s on eithe r        
28    * the req uest to a  resource ( a Comet se rvlet), or  on the re sponse fro m a resour ce, or bot h.        
29    * <br><br >        
30    * Filters  perform f iltering i n the <cod e>doFilter Event</cod e> method.  Every Fil ter has ac cess to        
31    * a Filte rConfig ob ject from  which it c an obtain  its initia lization p arameters,  a        
32    * referen ce to the  ServletCon text which  it can us e, for exa mple, to l oad resour ces        
33    * needed  for filter ing tasks.        
34    * <p>        
35    * Filters  are confi gured in t he deploym ent descri ptor of a  web applic ation        
36    * <p>        
37    * Example s that hav e been ide ntified fo r this des ign are<br >        
38    * 1) Auth entication  Filters < br>        
39    * 2) Logg ing and Au diting Fil ters <br>        
40    * 3) Imag e conversi on Filters  <br>        
41    * 4) Data  compressi on Filters  <br>        
42    * 5) Encr yption Fil ters <br>        
43    * 6) Toke nizing Fil ters <br>        
44    * 7) Filt ers that t rigger res ource acce ss events  <br>        
45    * 8) XSL/ T filters  <br>        
46    * 9) Mime -type chai n Filter < br>        
47    * <br>        
48    *        
49    * @author  Remy Mauc herat        
50    */        
51   public int erface Com etFilter e xtends Fil ter {        
52          
53          
54       /**        
55        * The  <code>doF ilterEvent </code> me thod of th e CometFil ter is cal led by the  container        
56        * eac h time a r equest/res ponse pair  is passed  through t he chain d ue        
57        * to  a client e vent for a  resource  at the end  of the ch ain. The C ometFilter Chain pass ed in to t his        
58        * met hod allows  the Filte r to pass  on the eve nt to the  next entit y in the        
59        * cha in.<p>        
60        * A t ypical imp lementatio n of this  method wou ld follow  the follow ing patter n:- <br>        
61        * 1.  Examine th e request< br>        
62        * 2.  Optionally  wrap the  request ob ject conta ined in th e event wi th a custo m implemen tation to        
63        * fil ter conten t or heade rs for inp ut filteri ng and pas s a CometE vent insta nce contai ning        
64        * the  wrapped r equest to  the next f ilter<br>        
65        * 3.  Optionally  wrap the  response o bject cont ained in t he event w ith a cust om impleme ntation to        
66        * fil ter conten t or heade rs for out put filter ing and pa ss a Comet Event inst ance conta ining        
67        * the  wrapped r equest to  the next f ilter<br>        
68        * 4.  a) <strong >Either</s trong> inv oke the ne xt entity  in the cha in using t he CometFi lterChain  object (<c ode>chain. doFilterEv ent()</cod e>), <br>        
69        * 4.  b) <strong >or</stron g> not pas s on the r equest/res ponse pair  to the ne xt entity  in the fil ter chain  to block t he event p rocessing< br>        
70        * 5.  Directly s et fields  on the res ponse afte r invocati on of the  next entit y in the f ilter chai n.        
71        *        
72        * @pa ram event  the event  that is be ing proces sed. Anoth er event m ay be pass ed along t he chain.        
73        * @pa ram chain        
74        * @th rows IOExc eption        
75        * @th rows Servl etExceptio n        
76        */        
77       public  void doFi lterEvent( CometEvent  event, Co metFilterC hain chain )        
78           th rows IOExc eption, Se rvletExcep tion;        
79          
80          
81   }