• Home
• org.eclipse.birt.runtime
• viewservlets
• 4.4.1
• source code
• ViewerServlet.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

org.eclipse.birt.report.servlet.ViewerServlet Maven / Gradle / Ivy

/*************************************************************************************
 * Copyright (c) 2004 Actuate 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:
 *     Actuate Corporation - Initial implementation.
 ************************************************************************************/

package org.eclipse.birt.report.servlet;

import java.io.IOException;
import java.io.UnsupportedEncodingException;

import javax.servlet.ServletConfig;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.eclipse.birt.core.exception.BirtException;
import org.eclipse.birt.report.IBirtConstants;
import org.eclipse.birt.report.service.BirtReportServiceFactory;
import org.eclipse.birt.report.service.BirtViewerReportService;
import org.eclipse.birt.report.servlet.BirtSoapMessageDispatcherServlet;
import org.eclipse.birt.report.utility.BirtUtility;
import org.eclipse.birt.report.utility.ParameterAccessor;
import org.eclipse.birt.report.context.BirtContext;
import org.eclipse.birt.report.context.IContext;
import org.eclipse.birt.report.presentation.aggregation.IFragment;
import org.eclipse.birt.report.presentation.aggregation.layout.FramesetFragment;
import org.eclipse.birt.report.presentation.aggregation.layout.RunFragment;

/**
 * Servlet implementation of BIRT Web Viewer.
 * 

 * There are four servlet mappings defined for ViewerServlet in the web.xml.
 * 

 * 
Frameset - Displays the whole web viewer frameset. (Public)
 * 
Run - Runs the report and displays the output as a stand-alone HTML
 * page, or as a PDF document. (Public)
 * 
Navigation - Displays the leftside navigation frame that contains the
 * report parameter page. (Internal)
 * 
Toolbar - Displays the toolbar above the report content. (Internal)
 * 
 * 

 * Each public mapping expects some URL parameters,
 * 

 * 
Frameset
 * 

 * 
__report
 * 
__locale
 * 
report parameter
 * 
 * 
Run
 * 

 * 
__report
 * 
__format
 * 
__locale
 * 
__page
 * 
report parameter
 * 
 * 
 * 

 * Each URL parameter is described below. 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
Parameter
Description
Values
Default
__report
The path to the report document
 
required
__format
The output format
html or pdf
optional, default to html
__locale
Report locale
Java locale value such as en or ch-zh.
optional, default to JVM locale
__page
Report page number
Report page to be viewed.
optional, default to 0
reportParam
User defined report parameter.
As specified in the report design.
As specified in the report design.
 * 

 */
public class ViewerServlet extends BirtSoapMessageDispatcherServlet
{

	/**
	 * TODO: what's this?
	 */
	private static final long serialVersionUID = 1L;

	/**
	 * Local initialization.
	 * 
	 * @return
	 */
	protected void __init( ServletConfig config )
	{
		BirtReportServiceFactory.init( new BirtViewerReportService( config
				.getServletContext( ) ) );

		// handle 'frameset' pattern
		viewer = new FramesetFragment( );
		viewer.buildComposite( );
		viewer.setJSPRootPath( "/webcontent/birt" ); //$NON-NLS-1$

		// handle 'run' pattern
		run = new RunFragment( );
		run.buildComposite( );
		run.setJSPRootPath( "/webcontent/birt" ); //$NON-NLS-1$		
	}

	/**
	 * Init context.
	 * 
	 * @param request
	 *            incoming http request
	 * @param response
	 *            http response
	 * @exception BirtException
	 * @return IContext
	 */
	protected IContext __getContext( HttpServletRequest request,
			HttpServletResponse response ) throws BirtException
	{
		BirtReportServiceFactory.getReportService( ).setContext(
				getServletContext( ), null );
		return new BirtContext( request, response );
	}

	/**
	 * Local process http request with GET method.
	 * 
	 * @param request
	 *            incoming http request
	 * @param response
	 *            http response
	 * @exception ServletException
	 * @exception IOException
	 * @return
	 */
	protected void __doGet( IContext context ) throws ServletException,
			IOException, BirtException
	{
		IFragment activeFragment = null;
		String servletPath = context.getRequest( ).getServletPath( );
		if ( IBirtConstants.SERVLET_PATH_FRAMESET
				.equalsIgnoreCase( servletPath ) )
		{
			activeFragment = viewer;
		}
		else if ( IBirtConstants.SERVLET_PATH_RUN
				.equalsIgnoreCase( servletPath ) )
		{
			activeFragment = run;
		}

		if ( activeFragment != null )
			activeFragment.service( context.getRequest( ), context
					.getResponse( ) );
	}

	/**
	 * Locale process http request with POST method. Four different servlet
	 * paths are expected: "/frameset", "/navigation", "/toolbar", and "/run".
	 * 
	 * @param request
	 *            incoming http request
	 * @param response
	 *            http response
	 * @exception ServletException
	 * @exception IOException
	 * @return
	 */
	protected void __doPost( IContext context ) throws ServletException,
			IOException, BirtException
	{
	}

	/**
	 * Local authentication. Alwasy returns true.
	 * 
	 * @param request
	 *            incoming http request
	 * @param response
	 *            http response
	 * @return
	 */
	protected boolean __authenticate( HttpServletRequest request,
			HttpServletResponse response )
	{
		return true;
	}

	/**
	 * Process exception for non soap request.
	 * 
	 * @param request
	 *            incoming http request
	 * @param response
	 *            http response
	 * @param exception
	 * @throws ServletException
	 * @throws IOException
	 */
	protected void __handleNonSoapException( HttpServletRequest request,
			HttpServletResponse response, Exception exception )
			throws ServletException, IOException
	{
		exception.printStackTrace( );
		BirtUtility.appendErrorMessage( response.getOutputStream( ), exception );
	}
}