ClassfileLoader.java

  1. /*
  2.  *  Copyright (c) 2001-2024, Jean Tessier
  3.  *  All rights reserved.
  4.  *  
  5.  *  Redistribution and use in source and binary forms, with or without
  6.  *  modification, are permitted provided that the following conditions
  7.  *  are met:
  8.  *  
  9.  *      * Redistributions of source code must retain the above copyright
  10.  *        notice, this list of conditions and the following disclaimer.
  11.  *  
  12.  *      * Redistributions in binary form must reproduce the above copyright
  13.  *        notice, this list of conditions and the following disclaimer in the
  14.  *        documentation and/or other materials provided with the distribution.
  15.  *  
  16.  *      * Neither the name of Jean Tessier nor the names of his contributors
  17.  *        may be used to endorse or promote products derived from this software
  18.  *        without specific prior written permission.
  19.  *  
  20.  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  21.  *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  22.  *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  23.  *  A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
  24.  *  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  25.  *  EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  26.  *  PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  27.  *  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  28.  *  LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  29.  *  NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  30.  *  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  31.  */

  32. package com.jeantessier.classreader;

  33. import java.io.*;
  34. import java.util.*;

  35. /**
  36.  *  Base interface for parsing <code>.class</code> files.
  37.  *  This should have been a Java interface, but I needed
  38.  *  the protected contract for the Decorator Pattern.
  39.  *
  40.  *  @see ClassfileLoaderDecorator
  41.  */
  42. public abstract class ClassfileLoader {
  43.     // Main methods
  44.     public abstract Classfile getClassfile(String name);
  45.     public abstract Collection<Classfile> getAllClassfiles();
  46.     public abstract Collection<String> getAllClassNames();

  47.     public void load(Collection<String> filenames) {
  48.         fireBeginSession();

  49.         filenames.forEach(this::load);

  50.         fireEndSession();
  51.     }

  52.     // Protected contract for Decorator Pattern
  53.     protected abstract void load(String filename);
  54.     protected abstract void load(String filename, InputStream in);
  55.     protected abstract Classfile load(DataInput in) throws IOException;

  56.     // Event stuff
  57.     public abstract void addLoadListener(LoadListener listener);
  58.     public abstract void removeLoadListener(LoadListener listener);
  59.     protected abstract void fireBeginSession();
  60.     protected abstract void fireBeginGroup(String group_name, int size);
  61.     protected abstract void fireBeginClassfile(String filename);
  62.     protected abstract void fireBeginFile(String filename);
  63.     protected abstract void fireEndClassfile(String filename, Classfile classfile);
  64.     protected abstract void fireEndFile(String filename);
  65.     protected abstract void fireEndGroup(String group_name);
  66.     protected abstract void fireEndSession();
  67. }