code: public static char[] getJavaSourceFromTheInputStream( InputStream inputStream,
                                                            long length,
                                                            String encoding ) throws IOException {
          return Util.getInputStreamAsCharArray(inputStream, (int)length, encoding);
      }
docs: Gets Java source from the <code>InputStream</code>.
  
  @param inputStream - the <code>FileInputStream</code>.
  @param length - the length of the java file.
  @param encoding - the encoding of the source, if there is one.
  @return the array character of the java source.
  @throws java.io.IOException - exceptional error can be thrown during the reading of the file.