improved comments and provided way to force disable of service search in class path

Author: raydac

jcp/src/main/java/com/igormaznitsa/jcp/context/CommentTextProcessor.java

@@ -4,9 +4,11 @@
 import java.io.IOException;
 
 /**
- * Custom processor to detect and process text line or text block
+ * Custom processor to detect and process uncommenting text line or text block
  * defined through //$ and //$$ directives. It can return the same value or
- * changed one.
+ * changed one. The processor is called after ext prepared for injection into preprocessed source.
+ * If activated merge block mode for preprocessor so sequentially
+ * situated lines started with """ will be merged into single text block (and """ will be removed)
  *
  * @since 7.2.0
  */

jcp/src/main/java/com/igormaznitsa/jcp/utils/PreprocessorUtils.java

@@ -62,6 +62,13 @@
  */
 public final class PreprocessorUtils {
 
+  /**
+   * Property if defined and true then search of services in class path is disabled.
+   *
+   * @since 7.2.0
+   */
+  public static final String SYSTEM_PROPERTY_DISABLE_SEARCH_SERVICES =
+      "jcp.preprocessor.disable.search.services";
   private static final Pattern PATTERN_MACROS_WITH_SPACES =
       Pattern.compile("\\/\\*\\s*\\$(.*?)\\$\\s*\\*\\/");
 
@@ -113,7 +120,6 @@ public static PreprocessorExtension findAndInstantiatePreprocessorExtensionForCl
     }
   }
 
-
   /**
    * Find comment remover type for provided identifier. Decoding also true and false values.
    *
@@ -154,7 +160,6 @@ public static String getFileExtension(final File file) {
     return result;
   }
 
-
   public static BufferedReader makeFileReader(final File file, final Charset charset,
                                               final int bufferSize) throws IOException {
     Objects.requireNonNull(file, "File is null");
@@ -182,12 +187,10 @@ public static String[] replaceChar(final String[] source,
     return result;
   }
 
-
   public static String extractTrimmedTail(final String prefix, final String value) {
     return extractTail(prefix, value).trim();
   }
 
-
   public static String extractTail(final String prefix, final String value) {
     Objects.requireNonNull(prefix, "Prefix is null");
     Objects.requireNonNull(value, "Value is null");
@@ -226,7 +229,6 @@ public static boolean copyFileAttributes(final File from, final File to) {
     return result;
   }
 
-
   public static String replacePartByChar(final String text, final char chr, final int startPosition,
                                          final int length) {
     if (startPosition < 0) {
@@ -247,6 +249,9 @@ public static String replacePartByChar(final String text, final char chr, final
   }
 
   public static <T> List<T> findAndInstantiateAllServices(final Class<T> serviceClass) {
+    if (Boolean.getBoolean(SYSTEM_PROPERTY_DISABLE_SEARCH_SERVICES)) {
+      return List.of();
+    }
     final ServiceLoader<T> serviceLoader = ServiceLoader.load(serviceClass);
     return serviceLoader.stream().map(ServiceLoader.Provider::get).collect(Collectors.toList());
   }