How to use

HtmlStaplerBundlesManager

in

jodd.htmlstapler

  @Test
  void testRandomDigest() {
    HtmlStaplerBundlesManager hsbm = new HtmlStaplerBundlesManager("/ctx", "/", RESOURCES_ONLY);

    String digest = hsbm.createDigest("source");

    hsbm.setRandomDigestChars(5);

    String digest2 = hsbm.createDigest("source");
    String digest3 = hsbm.createDigest("source");

    assertEquals(digest2, digest3);
    assertTrue(digest2.startsWith(digest));


    hsbm.setRandomDigestChars(0);

    digest2 = hsbm.createDigest("source");

    assertEquals(digest, digest2);
  }
}

String bundleId = createDigest(sourcesString);
bundleId += '.' + bundleContentType;
  createBundle(contextPath, actionPath, bundleId, sources);
} catch (IOException ioex) {
  throw new HtmlStaplerException("Can't create bundle", ioex);

/**
 * Lookups for bundle file.
 */
public File lookupBundleFile(String bundleId) {
  if ((mirrors != null) && (!mirrors.isEmpty())) {
    String realBundleId = mirrors.remove(bundleId);
    if (realBundleId != null) {
      bundleId = realBundleId;
    }
  }
  return createBundleFile(bundleId);
}

/**
 * Creates new bundle action.
 */
public BundleAction(final HtmlStaplerBundlesManager bundlesManager, final String servletPath, final String bundleContentType) {
  this.bundlesManager = bundlesManager;
  this.bundleContentType = bundleContentType;
  this.strategy = bundlesManager.getStrategy();
  String realActionPath = bundlesManager.resolveRealActionPath(servletPath);
  actionPath = realActionPath + '*' + bundleContentType;
  contextPath = bundlesManager.contextPath;
  if (strategy == ACTION_MANAGED) {
    bundleId = bundlesManager.lookupBundleId(actionPath);
    newAction = (bundleId == null);
    if (newAction) {
      sources = new ArrayList<>();
    }
  } else {
    bundleId = BUNDLE_ID_MARKER + bundleContentType;
    bundleIdMark = bundleId.toCharArray();
    newAction = true;
    sources = new ArrayList<>();
  }
  firstScriptTag = true;
}

@Override
protected boolean processActionPath(final HttpServletRequest servletRequest, final HttpServletResponse servletResponse, final String actionPath) throws IOException {
  String bundlePath = '/' + bundlesManager.getStaplerPath() + '/';
  if (!actionPath.startsWith(bundlePath)) {
    return false;
  }
  String bundleId = actionPath.substring(bundlePath.length());
  File file = bundlesManager.lookupBundleFile(bundleId);
  if (log.isDebugEnabled()) {
    log.debug("bundle: " + bundleId);
  }
  int ndx = bundleId.lastIndexOf('.');
  String extension = bundleId.substring(ndx + 1);
  String contentType = MimeTypes.getMimeType(extension);
  servletResponse.setContentType(contentType);
  if (useGzip && ServletUtil.isGzipSupported(servletRequest)) {
    file = bundlesManager.lookupGzipBundleFile(file);
    servletResponse.setHeader("Content-Encoding", "gzip");
  }
  if (!file.exists()) {
    throw new IOException("bundle not found: " + bundleId);
  }
  servletResponse.setHeader("Content-Length", String.valueOf(file.length()));
  servletResponse.setHeader("Last-Modified", TimeUtil.formatHttpDate(file.lastModified()));
  if (cacheMaxAge > 0) {
    servletResponse.setHeader("Cache-Control", "max-age=" + cacheMaxAge);
  }
  sendBundleFile(servletResponse, file);
  return true;
}

File bundleFile = createBundleFile(bundleId);
if (bundleFile.exists()) {
  return;
  if (isExternalResource(src)) {
    try {
      content = NetUtil.downloadString(src, localFilesEncoding);
      if (isCssResource(src)) {
        content = fixCssRelativeUrls(content, src);
    content = onResourceContent(content);
    sb.append(content);

  @Test
  void testRelativeCssUrls() {


    HtmlStaplerBundlesManager htmlStapler = new HtmlStaplerBundlesManager("/", "", HtmlStaplerBundlesManager.Strategy.RESOURCES_ONLY);

    assertEquals(
        "background: url('/absolute/path')",
        htmlStapler.fixCssRelativeUrls("background: url(/absolute/path)", "css/"));

    assertEquals(
        "background: url('../css/relative/path')",
        htmlStapler.fixCssRelativeUrls("background: url(relative/path)", "css/"));
  }
}

/**
 * Creates {@link HtmlStaplerBundlesManager} instance.
 */
protected HtmlStaplerBundlesManager createBundleManager(final ServletContext servletContext, final Strategy strategy) {
  String webRoot = servletContext.getRealPath(StringPool.EMPTY);
  String contextPath = ServletUtil.getContextPath(servletContext);
  return new HtmlStaplerBundlesManager(contextPath, webRoot, strategy);
}

/**
 * Builds stapler URL based on bundle action data.
 */
protected String buildStaplerUrl() {
  return contextPath + '/' + bundlesManager.getStaplerPath() + '/' + bundleId;
}

/**
 * Returns the content with all relative URLs fixed.
 */
protected String fixCssRelativeUrls(final String content, final String src) {
  String path = FileNameUtil.getPath(src);
  Matcher matcher = CSS_URL_PATTERN.matcher(content);
  StringBuilder sb = new StringBuilder(content.length());
  int start = 0;
  while (matcher.find()) {
    sb.append(content.substring(start, matcher.start()));
    String url = fixRelativeUrl(matcher.group(1), path);
    sb.append(url);
    start = matcher.end();
  }
  sb.append(content.substring(start));
  return sb.toString();
}

File bundleFile = createBundleFile(bundleId);
if (bundleFile.exists()) {
  return;
  if (isExternalResource(src)) {
    try {
      content = NetUtil.downloadString(src, localFilesEncoding);
      if (isCssResource(src)) {
        content = fixCssRelativeUrls(content, src);
    content = onResourceContent(content);
    sb.append(content);

/**
 * Creates new bundle action.
 */
public BundleAction(final HtmlStaplerBundlesManager bundlesManager, final String servletPath, final String bundleContentType) {
  this.bundlesManager = bundlesManager;
  this.bundleContentType = bundleContentType;
  this.strategy = bundlesManager.getStrategy();
  String realActionPath = bundlesManager.resolveRealActionPath(servletPath);
  actionPath = realActionPath + '*' + bundleContentType;
  contextPath = bundlesManager.contextPath;
  if (strategy == ACTION_MANAGED) {
    bundleId = bundlesManager.lookupBundleId(actionPath);
    newAction = (bundleId == null);
    if (newAction) {
      sources = new ArrayList<>();
    }
  } else {
    bundleId = BUNDLE_ID_MARKER + bundleContentType;
    bundleIdMark = bundleId.toCharArray();
    newAction = true;
    sources = new ArrayList<>();
  }
  firstScriptTag = true;
}

@Override
protected boolean processActionPath(final HttpServletRequest servletRequest, final HttpServletResponse servletResponse, final String actionPath) throws IOException {
  String bundlePath = '/' + bundlesManager.getStaplerPath() + '/';
  if (!actionPath.startsWith(bundlePath)) {
    return false;
  }
  String bundleId = actionPath.substring(bundlePath.length());
  File file = bundlesManager.lookupBundleFile(bundleId);
  if (log.isDebugEnabled()) {
    log.debug("bundle: " + bundleId);
  }
  int ndx = bundleId.lastIndexOf('.');
  String extension = bundleId.substring(ndx + 1);
  String contentType = MimeTypes.getMimeType(extension);
  servletResponse.setContentType(contentType);
  if (useGzip && ServletUtil.isGzipSupported(servletRequest)) {
    file = bundlesManager.lookupGzipBundleFile(file);
    servletResponse.setHeader("Content-Encoding", "gzip");
  }
  if (!file.exists()) {
    throw new IOException("bundle not found: " + bundleId);
  }
  servletResponse.setHeader("Content-Length", String.valueOf(file.length()));
  servletResponse.setHeader("Last-Modified", TimeUtil.formatHttpDate(file.lastModified()));
  if (cacheMaxAge > 0) {
    servletResponse.setHeader("Cache-Control", "max-age=" + cacheMaxAge);
  }
  sendBundleFile(servletResponse, file);
  return true;
}

/**
 * Creates {@link HtmlStaplerBundlesManager} instance.
 */
protected HtmlStaplerBundlesManager createBundleManager(final ServletContext servletContext, final Strategy strategy) {
  String webRoot = servletContext.getRealPath(StringPool.EMPTY);
  String contextPath = ServletUtil.getContextPath(servletContext);
  return new HtmlStaplerBundlesManager(contextPath, webRoot, strategy);
}

/**
 * Builds stapler URL based on bundle action data.
 */
protected String buildStaplerUrl() {
  return contextPath + '/' + bundlesManager.getStaplerPath() + '/' + bundleId;
}

/**
 * Returns the content with all relative URLs fixed.
 */
protected String fixCssRelativeUrls(final String content, final String src) {
  String path = FileNameUtil.getPath(src);
  Matcher matcher = CSS_URL_PATTERN.matcher(content);
  StringBuilder sb = new StringBuilder(content.length());
  int start = 0;
  while (matcher.find()) {
    sb.append(content.substring(start, matcher.start()));
    String url = fixRelativeUrl(matcher.group(1), path);
    sb.append(url);
    start = matcher.end();
  }
  sb.append(content.substring(start));
  return sb.toString();
}

String bundleId = createDigest(sourcesString);
bundleId += '.' + bundleContentType;
  createBundle(contextPath, actionPath, bundleId, sources);
} catch (IOException ioex) {
  throw new HtmlStaplerException("Can't create bundle", ioex);

/**
 * Lookups for bundle file.
 */
public File lookupBundleFile(String bundleId) {
  if ((mirrors != null) && (!mirrors.isEmpty())) {
    String realBundleId = mirrors.remove(bundleId);
    if (realBundleId != null) {
      bundleId = realBundleId;
    }
  }
  return createBundleFile(bundleId);
}