167. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 9/25/2018 2:13:10 PM Central Daylight 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.

167.1 Files compared

# Location File Last Modified
1 build 3.zip\build 3\MHLTH_YS_137_Source\JavaScript\resources\javaJDF-1.8.0\src\java\rmi\activation ActivationSystem.java Mon Jan 22 14:46:52 2018 UTC
2 build 3.zip\build 3\MHLTH_YS_137_Source\JavaScript\resources\javaJDF-1.8.0\src\java\rmi\activation ActivationSystem.java Wed Sep 12 17:11:47 2018 UTC

167.2 Comparison summary

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

167.3 Comparison options

Whitespace
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

167.4 Active regular expressions

No regular expressions were active.

167.5 Comparison detail

  1   /*
  2    * Copyrig ht (c) 199 7, 2003, O racle and/ or its aff iliates. A ll rights  reserved.
  3    * DO NOT  ALTER OR R EMOVE COPY RIGHT NOTI CES OR THI S FILE HEA DER.
  4    *
  5    * This co de is free  software;  you can r edistribut e it and/o r modify i t
  6    * under t he terms o f the GNU  General Pu blic Licen se version  2 only, a s
  7    * publish ed by the  Free Softw are Founda tion.  Ora cle design ates this
  8    * particu lar file a s subject  to the "Cl asspath" e xception a s provided
  9    * by Orac le in the  LICENSE fi le that ac companied  this code.
  10    *
  11    * This co de is dist ributed in  the hope  that it wi ll be usef ul, but WI THOUT
  12    * ANY WAR RANTY; wit hout even  the implie d warranty  of MERCHA NTABILITY  or
  13    * FITNESS  FOR A PAR TICULAR PU RPOSE.  Se e the GNU  General Pu blic Licen se
  14    * version  2 for mor e details  (a copy is  included  in the LIC ENSE file  that
  15    * accompa nied this  code).
  16    *
  17    * You sho uld have r eceived a  copy of th e GNU Gene ral Public  License v ersion
  18    * 2 along  with this  work; if  not, write  to the Fr ee Softwar e Foundati on,
  19    * Inc., 5 1 Franklin  St, Fifth  Floor, Bo ston, MA 0 2110-1301  USA.
  20    *
  21    * Please  contact Or acle, 500  Oracle Par kway, Redw ood Shores , CA 94065  USA
  22    * or visi t www.orac le.com if  you need a dditional  informatio n or have  any
  23    * questio ns.
  24    */
  25  
  26   package ja va.rmi.act ivation;
  27  
  28   import jav a.rmi.Remo te;
  29   import jav a.rmi.Remo teExceptio n;
  30   import jav a.rmi.acti vation.Unk nownGroupE xception;
  31   import jav a.rmi.acti vation.Unk nownObject Exception;
  32  
  33   /**
  34    * The <co de>Activat ionSystem< /code> pro vides a me ans for re gistering
  35    * groups  and "activ atable" ob jects to b e activate d within t hose group s.
  36    * The <co de>Activat ionSystem< /code> wor ks closely  with the
  37    * <code>A ctivator</ code>, whi ch activat es objects  registere d via the
  38    * <code>A ctivationS ystem</cod e>, and th e <code>Ac tivationMo nitor</cod e>,
  39    * which o btains inf ormation a bout activ e and inac tive objec ts,
  40    * and ina ctive grou ps.
  41    *
  42    * @author       Ann  Wollrath
  43    * @see          Acti vator
  44    * @see          Acti vationMoni tor
  45    * @since        1.2
  46    */
  47   public int erface Act ivationSys tem extend s Remote {
  48  
  49       /** Th e port to  lookup the  activatio n system.  */
  50         public sta tic final  int SYSTEM _PORT        
;
  51  
  52       /**
  53        * The  <code>reg isterObjec t</code> m ethod is u sed to reg ister an
  54        * act ivation de scriptor,  <code>desc </code>, a nd obtain  an
  55        * act ivation id entifier f or a activ atable rem ote object . The
  56        * <co de>Activat ionSystem< /code> cre ates an
  57        * <co de>Activat ionID</cod e> (a acti vation ide ntifier) f or the
  58        * obj ect specif ied by the  descripto r, <code>d esc</code> , and
  59        * rec ords, in s table stor age, the a ctivation  descriptor  and its
  60        * ass ociated id entifier f or later u se. When t he <code>A ctivator</ code>
  61        * rec eives an < code>activ ate</code>  request f or a speci fic identi fier, it
  62        * loo ks up the  activation  descripto r (registe red previo usly) for
  63        * the  specified  identifie r and uses  that info rmation to  activate
  64        * the  object. < p>
  65        *
  66        * @pa ram desc t he object' s activati on descrip tor
  67        * @re turn the a ctivation  id that ca n be used  to activat e the obje ct
  68        * @ex ception Ac tivationEx ception if  registrat ion fails  (e.g., dat abase
  69        * upd ate failur e, etc).
  70        * @ex ception Un knownGroup Exception  if group r eferred to  in
  71        * <co de>desc</c ode> is no t register ed with th is system
  72        * @ex ception Re moteExcept ion if rem ote call f ails
  73        * @si nce 1.2
  74        */
  75       public  Activatio nID regist erObject(A ctivationD esc desc)
  76           th rows Activ ationExcep tion, Unkn ownGroupEx ception, R emoteExcep tion;
  77  
  78       /**
  79        * Rem ove the ac tivation i d and asso ciated des criptor pr eviously
  80        * reg istered wi th the <co de>Activat ionSystem< /code>; th e object
  81        * can  no longer  be activa ted via th e object's  activatio n id.
  82        *
  83        * @pa ram id the  object's  activation  id (from  previous r egistratio n)
  84        * @ex ception Ac tivationEx ception if  unregiste r fails (e .g., datab ase
  85        * upd ate failur e, etc).
  86        * @ex ception Un knownObjec tException  if object  is unknow n (not reg istered)
  87        * @ex ception Re moteExcept ion if rem ote call f ails
  88        * @si nce 1.2
  89        */
  90       public  void unre gisterObje ct(Activat ionID id)
  91           th rows Activ ationExcep tion, Unkn ownObjectE xception,  RemoteExce ption;
  92  
  93       /**
  94        * Reg ister the  activation  group. An  activatio n group mu st be
  95        * reg istered wi th the <co de>Activat ionSystem< /code> bef ore object s
  96        * can  be regist ered withi n that gro up.
  97        *
  98        * @pa ram desc t he group's  descripto r
  99        * @re turn an id entifier f or the gro up
  100        * @ex ception Ac tivationEx ception if  group reg istration  fails
  101        * @ex ception Re moteExcept ion if rem ote call f ails
  102        * @si nce 1.2
  103        */
  104       public  Activatio nGroupID r egisterGro up(Activat ionGroupDe sc desc)
  105           th rows Activ ationExcep tion, Remo teExceptio n;
  106  
  107       /**
  108        * Cal lback to i nform acti vation sys tem that g roup is no w
  109        * act ive. This  call is ma de interna lly by the
  110        * <co de>Activat ionGroup.c reateGroup </code> me thod to in form
  111        * the  <code>Act ivationSys tem</code>  that the  group is n ow
  112        * act ive.
  113        *
  114        * @pa ram id the  activatio n group's  identifier
  115        * @pa ram group  the group' s instanti ator
  116        * @pa ram incarn ation the  group's in carnation  number
  117        * @re turn monit or for act ivation gr oup
  118        * @ex ception Un knownGroup Exception  if group i s not regi stered
  119        * @ex ception Ac tivationEx ception if  a group f or the spe cified
  120        * <co de>id</cod e> is alre ady active  and that  group is n ot equal
  121        * to  the specif ied <code> group</cod e> or that  group has  a differe nt
  122        * <co de>incarna tion</code > than the  specified  <code>gro up</code>
  123        * @ex ception Re moteExcept ion if rem ote call f ails
  124        * @si nce 1.2
  125        */
  126       public  Activatio nMonitor a ctiveGroup (Activatio nGroupID i d,
  127                                                Activatio nInstantia tor group,
  128                                                long inca rnation)
  129           th rows Unkno wnGroupExc eption, Ac tivationEx ception, R emoteExcep tion;
  130  
  131       /**
  132        * Rem ove the ac tivation g roup. An a ctivation  group make s this cal l back
  133        * to  inform the  activator  that the  group shou ld be remo ved (destr oyed).
  134        * If  this call  completes  successful ly, object s can no l onger be
  135        * reg istered or  activated  within th e group. A ll informa tion of th e
  136        * gro up and its  associate d objects  is removed  from the  system.
  137        *
  138        * @pa ram id the  activatio n group's  identifier
  139        * @ex ception Ac tivationEx ception if  unregiste r fails (e .g., datab ase
  140        * upd ate failur e, etc).
  141        * @ex ception Un knownGroup Exception  if group i s not regi stered
  142        * @ex ception Re moteExcept ion if rem ote call f ails
  143        * @si nce 1.2
  144        */
  145       public  void unre gisterGrou p(Activati onGroupID  id)
  146           th rows Activ ationExcep tion, Unkn ownGroupEx ception, R emoteExcep tion;
  147  
  148       /**
  149        * Shu tdown the  activation  system. D estroys al l groups s pawned by
  150        * the  activatio n daemon a nd exits t he activat ion daemon .
  151        * @ex ception Re moteExcept ion if fai led to con tact/shutd own the ac tivation
  152        * dae mon
  153        * @si nce 1.2
  154        */
  155       public  void shut down() thr ows Remote Exception;
  156  
  157       /**
  158        * Set  the activ ation desc riptor, <c ode>desc</ code> for  the object  with
  159        * the  activatio n identifi er, <code> id</code>.  The chang e will tak e
  160        * eff ect upon s ubsequent  activation  of the ob ject.
  161        *
  162        * @pa ram id the  activatio n identifi er for the  activatab le object
  163        * @pa ram desc t he activat ion descri ptor for t he activat able objec t
  164        * @ex ception Un knownGroup Exception  the group  associated  with
  165        * <co de>desc</c ode> is no t a regist ered group
  166        * @ex ception Un knownObjec tException  the activ ation <cod e>id</code >
  167        * is  not regist ered
  168        * @ex ception Ac tivationEx ception fo r general  failure (e .g., unabl e
  169        * to  update log )
  170        * @ex ception Re moteExcept ion if rem ote call f ails
  171        * @re turn the p revious va lue of the  activatio n descript or
  172        * @se e #getActi vationDesc
  173        * @si nce 1.2
  174        */
  175       public  Activatio nDesc setA ctivationD esc(Activa tionID id,
  176                                                   Activa tionDesc d esc)
  177           th rows Activ ationExcep tion, Unkn ownObjectE xception,
  178                UnknownG roupExcept ion, Remot eException ;
  179  
  180       /**
  181        * Set  the activ ation grou p descript or, <code> desc</code > for the  object
  182        * wit h the acti vation gro up identif ier, <code >id</code> . The chan ge will
  183        * tak e effect u pon subseq uent activ ation of t he group.
  184        *
  185        * @pa ram id the  activatio n group id entifier f or the act ivation gr oup
  186        * @pa ram desc t he activat ion group  descriptor  for the a ctivation  group
  187        * @ex ception Un knownGroup Exception  the group  associated  with
  188        * <co de>id</cod e> is not  a register ed group
  189        * @ex ception Ac tivationEx ception fo r general  failure (e .g., unabl e
  190        * to  update log )
  191        * @ex ception Re moteExcept ion if rem ote call f ails
  192        * @re turn the p revious va lue of the  activatio n group de scriptor
  193        * @se e #getActi vationGrou pDesc
  194        * @si nce 1.2
  195        */
  196       public  Activatio nGroupDesc  setActiva tionGroupD esc(Activa tionGroupI D id,
  197                                                              Activa tionGroupD esc desc)
  198          thr ows Activa tionExcept ion, Unkno wnGroupExc eption, Re moteExcept ion;
  199  
  200       /**
  201        * Ret urns the a ctivation  descriptor , for the  object wit h the acti vation
  202        * ide ntifier, < code>id</c ode>.
  203        *
  204        * @pa ram id the  activatio n identifi er for the  activatab le object
  205        * @ex ception Un knownObjec tException  if <code> id</code>  is not reg istered
  206        * @ex ception Ac tivationEx ception fo r general  failure
  207        * @ex ception Re moteExcept ion if rem ote call f ails
  208        * @re turn the a ctivation  descriptor
  209        * @se e #setActi vationDesc
  210        * @si nce 1.2
  211        */
  212       public  Activatio nDesc getA ctivationD esc(Activa tionID id)
  213          thr ows Activa tionExcept ion, Unkno wnObjectEx ception, R emoteExcep tion;
  214  
  215       /**
  216        * Ret urns the a ctivation  group desc riptor, fo r the grou p
  217        * wit h the acti vation gro up identif ier, <code >id</code> .
  218        *
  219        * @pa ram id the  activatio n group id entifier f or the gro up
  220        * @ex ception Un knownGroup Exception  if <code>i d</code> i s not regi stered
  221        * @ex ception Ac tivationEx ception fo r general  failure
  222        * @ex ception Re moteExcept ion if rem ote call f ails
  223        * @re turn the a ctivation  group desc riptor
  224        * @se e #setActi vationGrou pDesc
  225        * @si nce 1.2
  226        */
  227       public  Activatio nGroupDesc  getActiva tionGroupD esc(Activa tionGroupI D id)
  228          thr ows Activa tionExcept ion, Unkno wnGroupExc eption, Re moteExcept ion;
  229   }