| /******************************************************************************* |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| *******************************************************************************/ |
| package org.apache.ofbiz.widget.renderer.html; |
| |
| import java.io.IOException; |
| |
| import org.apache.ofbiz.base.util.UtilHttp; |
| import org.apache.ofbiz.widget.model.ModelWidget; |
| |
| /** |
| * Widget Library - HTML Widget Renderer implementation. HtmlWidgetRenderer |
| * is a base class that is extended by other widget HTML rendering classes. |
| */ |
| public class HtmlWidgetRenderer { |
| public static final String module = HtmlWidgetRenderer.class.getName(); |
| |
| /** |
| * Characters that are appended to the end of each rendered element. Currently set to |
| * CR/LF. |
| */ |
| public static final String whiteSpace = "\r\n"; |
| |
| protected boolean widgetCommentsEnabled = false; |
| |
| /** |
| * Helper method used to append whitespace characters to the end of each rendered element. |
| * @param writer The writer to write to |
| */ |
| public void appendWhitespace(Appendable writer) throws IOException { |
| writer.append(whiteSpace); |
| } |
| |
| /** |
| * Helper method used to build the boundary comment string. |
| * @param boundaryType The boundary type: "Begin" or "End" |
| * @param widgetType The widget type: "Screen Widget", "Form Widget", etc. |
| * @param widgetName The widget name |
| */ |
| public String buildBoundaryComment(String boundaryType, String widgetType, String widgetName) { |
| return formatBoundaryComment(boundaryType, widgetType, widgetName); |
| } |
| |
| public static String formatBoundaryComment(String boundaryType, String widgetType, String widgetName) { |
| return "<!-- " + boundaryType + " " + widgetType + " " + widgetName + " -->" + whiteSpace; |
| } |
| |
| /** |
| * Renders the beginning boundary comment string. |
| * @param writer The writer to write to |
| * @param widgetType The widget type: "Screen Widget", "Form Widget", etc. |
| * @param modelWidget The widget |
| */ |
| public void renderBeginningBoundaryComment(Appendable writer, String widgetType, ModelWidget modelWidget) throws IOException { |
| if (this.widgetCommentsEnabled) { |
| writer.append(this.buildBoundaryComment("Begin", widgetType, modelWidget.getBoundaryCommentName())); |
| } |
| } |
| |
| /** |
| * Renders the ending boundary comment string. |
| * @param writer The writer to write to |
| * @param widgetType The widget type: "Screen Widget", "Form Widget", etc. |
| * @param modelWidget The widget |
| */ |
| public void renderEndingBoundaryComment(Appendable writer, String widgetType, ModelWidget modelWidget) throws IOException { |
| if (this.widgetCommentsEnabled) { |
| writer.append(this.buildBoundaryComment("End", widgetType, modelWidget.getBoundaryCommentName())); |
| } |
| } |
| |
| /** Extracts parameters from a target URL string, prepares them for an Ajax |
| * JavaScript call. This method is currently set to return a parameter string |
| * suitable for the Prototype.js library. |
| * @param target Target URL string |
| * @return Parameter string |
| */ |
| public static String getAjaxParamsFromTarget(String target) { |
| String targetParams = UtilHttp.getQueryStringFromTarget(target); |
| targetParams = targetParams.replace("?", ""); |
| targetParams = targetParams.replace("&", "&"); |
| return targetParams; |
| } |
| } |