| /******************************************************************************* |
| * Copyright (c) 2011, 2016 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v1.0 |
| * which accompanies this distribution, and is available at |
| * http://www.eclipse.org/legal/epl-v10.html |
| * |
| * Contributors: |
| * IBM Corporation - initial API and implementation |
| *******************************************************************************/ |
| package org.eclipse.help.internal.webapp.service; |
| |
| import java.io.ByteArrayInputStream; |
| import java.io.IOException; |
| import java.io.InputStream; |
| import java.nio.charset.StandardCharsets; |
| |
| import javax.servlet.ServletException; |
| import javax.servlet.http.HttpServletRequest; |
| import javax.servlet.http.HttpServletResponse; |
| |
| import org.eclipse.help.internal.webapp.parser.ContextParser; |
| import org.eclipse.help.internal.webapp.servlet.ContextServlet; |
| import org.eclipse.help.internal.webapp.utils.Utils; |
| |
| /** |
| * Returns a context help entry with the id specified in the |
| * <code>id</code> parameter in <code>xml</code> or <code>json</code> form. |
| * |
| * <p>This servlet is called on infocenters by client workbenches |
| * configured for remote help in order to retrieve context help |
| * stored on the remote help server. |
| * |
| * <p>Extends the {@link org.eclipse.help.internal.webapp.servlet.ContextServlet} |
| * servlet. |
| * |
| * @param id - A <code>String</code> specifying the context id |
| * for the context help entry |
| * @param lang - (optional) A <code>String</code> specifying the locale |
| * @param returnType - (Optional) A <code>String</code> specifying the |
| * return type of the servlet. Accepts either |
| * <code>xml</code> (default) or <code>json</code> |
| * |
| * @return A context help entry with the id specified, either as |
| * <code>xml</code> (default) or <code>json</code> |
| * |
| * @exception 400 Error - If context <code>id</code> parameter is missing |
| * @exception 404 Error - If wrong context <code>id</code> parameter |
| * |
| * @version $Version$ |
| * |
| **/ |
| public class ContextService extends ContextServlet { |
| |
| private static final long serialVersionUID = 1L; |
| |
| @Override |
| protected void doGet(HttpServletRequest req, HttpServletResponse resp) |
| throws ServletException, IOException { |
| |
| req.setCharacterEncoding("UTF-8"); //$NON-NLS-1$ |
| // Set standard HTTP/1.1 no-cache headers. |
| resp.setHeader("Cache-Control", //$NON-NLS-1$ |
| "no-store, no-cache, must-revalidate"); //$NON-NLS-1$ |
| |
| String response = processRequest(req, resp); |
| if ("400".equals(response)) { //$NON-NLS-1$ |
| resp.sendError(400); // bad request; missing parameter |
| return; |
| } else if ("404".equals(response)) { //$NON-NLS-1$ |
| resp.sendError(404); // Wrong context id; not found |
| return; |
| } |
| |
| String returnType = req.getParameter(Utils.RETURN_TYPE); |
| boolean boolIsJSON = (returnType != null |
| && returnType.equalsIgnoreCase(Utils.JSON)); |
| |
| // If JSON output is required |
| if (boolIsJSON) { |
| resp.setContentType("text/plain"); //$NON-NLS-1$ |
| response = getJSONResponse(response); |
| } |
| |
| resp.getWriter().write(response); |
| } |
| |
| protected String getJSONResponse(String response) |
| throws IOException { |
| ContextParser searchParser = new ContextParser(); |
| if (response != null) { |
| try (InputStream is = new ByteArrayInputStream(response.getBytes(StandardCharsets.UTF_8))) { |
| searchParser.parse(is); |
| } catch (Exception e) { |
| e.printStackTrace(); |
| } |
| } |
| |
| // Call after the catch. |
| // An empty JSON is created if any Exception is thrown |
| // Else returns the complete JSON |
| return searchParser.toJSON(); |
| } |
| |
| } |