You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

VerifierFactory.java 5.4KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143
  1. package org.aspectj.apache.bcel.verifier;
  2. /* ====================================================================
  3. * The Apache Software License, Version 1.1
  4. *
  5. * Copyright (c) 2001 The Apache Software Foundation. All rights
  6. * reserved.
  7. *
  8. * Redistribution and use in source and binary forms, with or without
  9. * modification, are permitted provided that the following conditions
  10. * are met:
  11. *
  12. * 1. Redistributions of source code must retain the above copyright
  13. * notice, this list of conditions and the following disclaimer.
  14. *
  15. * 2. Redistributions in binary form must reproduce the above copyright
  16. * notice, this list of conditions and the following disclaimer in
  17. * the documentation and/or other materials provided with the
  18. * distribution.
  19. *
  20. * 3. The end-user documentation included with the redistribution,
  21. * if any, must include the following acknowledgment:
  22. * "This product includes software developed by the
  23. * Apache Software Foundation (https://www.apache.org/)."
  24. * Alternately, this acknowledgment may appear in the software itself,
  25. * if and wherever such third-party acknowledgments normally appear.
  26. *
  27. * 4. The names "Apache" and "Apache Software Foundation" and
  28. * "Apache BCEL" must not be used to endorse or promote products
  29. * derived from this software without prior written permission. For
  30. * written permission, please contact apache@apache.org.
  31. *
  32. * 5. Products derived from this software may not be called "Apache",
  33. * "Apache BCEL", nor may "Apache" appear in their name, without
  34. * prior written permission of the Apache Software Foundation.
  35. *
  36. * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  37. * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  38. * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  39. * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  40. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  41. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  42. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  43. * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  44. * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  45. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  46. * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  47. * SUCH DAMAGE.
  48. * ====================================================================
  49. *
  50. * This software consists of voluntary contributions made by many
  51. * individuals on behalf of the Apache Software Foundation. For more
  52. * information on the Apache Software Foundation, please see
  53. * <https://www.apache.org/>.
  54. */
  55. import java.util.HashMap;
  56. import java.util.Iterator;
  57. import java.util.Vector;
  58. /**
  59. * This class produces instances of the Verifier class. Its purpose is to make
  60. * sure that they are singleton instances with respect to the class name they
  61. * operate on. That means, for every class (represented by a unique fully qualified
  62. * class name) there is exactly one Verifier.
  63. *
  64. * @version $Id: VerifierFactory.java,v 1.3 2009/09/09 19:56:20 aclement Exp $
  65. * @author <A HREF="https://www.inf.fu-berlin.de/~ehaase"/>Enver Haase</A>
  66. * @see org.aspectj.apache.bcel.verifier.Verifier
  67. */
  68. public class VerifierFactory{
  69. /**
  70. * The HashMap that holds the data about the already-constructed Verifier instances.
  71. */
  72. private static HashMap<String, Verifier> hashMap = new HashMap<String, Verifier>();
  73. /**
  74. * The VerifierFactoryObserver instances that observe the VerifierFactory.
  75. */
  76. private static Vector<VerifierFactoryObserver> observers = new Vector<VerifierFactoryObserver>();
  77. /**
  78. * The VerifierFactory is not instantiable.
  79. */
  80. private VerifierFactory(){}
  81. /**
  82. * Returns the (only) verifier responsible for the class with the given name.
  83. * Possibly a new Verifier object is transparently created.
  84. * @return the (only) verifier responsible for the class with the given name.
  85. */
  86. public static Verifier getVerifier(String fully_qualified_classname){
  87. // fully_qualified_classname = fully_qualified_classname;
  88. Verifier v = (hashMap.get(fully_qualified_classname));
  89. if (v==null){
  90. v = new Verifier(fully_qualified_classname);
  91. hashMap.put(fully_qualified_classname, v);
  92. notify(fully_qualified_classname);
  93. }
  94. return v;
  95. }
  96. /**
  97. * Notifies the observers of a newly generated Verifier.
  98. */
  99. private static void notify(String fully_qualified_classname){
  100. // notify the observers
  101. Iterator<VerifierFactoryObserver> i = observers.iterator();
  102. while (i.hasNext()){
  103. VerifierFactoryObserver vfo = i.next();
  104. vfo.update(fully_qualified_classname);
  105. }
  106. }
  107. /**
  108. * Returns all Verifier instances created so far.
  109. * This is useful when a Verifier recursively lets
  110. * the VerifierFactory create other Verifier instances
  111. * and if you want to verify the transitive hull of
  112. * referenced class files.
  113. */
  114. public static Verifier[] getVerifiers(){
  115. Verifier[] vs = new Verifier[hashMap.values().size()];
  116. return (hashMap.values().toArray(vs)); // Because vs is big enough, vs is used to store the values into and returned!
  117. }
  118. /**
  119. * Adds the VerifierFactoryObserver o to the list of observers.
  120. */
  121. public static void attach(VerifierFactoryObserver o){
  122. observers.addElement(o);
  123. }
  124. /**
  125. * Removes the VerifierFactoryObserver o from the list of observers.
  126. */
  127. public static void detach(VerifierFactoryObserver o){
  128. observers.removeElement(o);
  129. }
  130. }