All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.pentaho.di.www.StopTransServlet Maven / Gradle / Ivy

The newest version!
/*! ******************************************************************************
 *
 * Pentaho Data Integration
 *
 * Copyright (C) 2002-2018 by Hitachi Vantara : http://www.pentaho.com
 *
 *******************************************************************************
 *
 * Licensed 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.pentaho.di.www;

import java.io.IOException;
import java.io.PrintWriter;
import java.net.URLEncoder;

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

import org.owasp.encoder.Encode;
import org.pentaho.di.core.Const;
import org.pentaho.di.core.util.Utils;
import org.pentaho.di.core.xml.XMLHandler;
import org.pentaho.di.i18n.BaseMessages;
import org.pentaho.di.trans.Trans;


public class StopTransServlet extends BaseHttpServlet implements CartePluginInterface {
  private static Class PKG = StopTransServlet.class; // for i18n purposes, needed by Translator2!!

  private static final long serialVersionUID = 3634806745372015720L;
  public static final String CONTEXT_PATH = "/kettle/stopTrans";

  public StopTransServlet() {
  }

  public StopTransServlet( TransformationMap transformationMap ) {
    super( transformationMap );
  }

  /**
  

/kettle/stopTrans

GET

Stops transformation execution on Carte server.

Example Request:

      GET /kettle/stopTrans/?name=dummy-trans&xml=Y
      

Parameters

name description type
name Name of the transformation to be stopped. query
xml Boolean flag which sets the output format required. Use Y to receive XML response. boolean, optional
id Carte transformation ID of the transformation to be stopped. This parameter is optional when xml=Y is used. query, optional
inputOnly Boolean flag indicates which steps to stop. Use Y to Stop input processing boolean, optional

Response Body

text: HTML
media types: text/xml, text/html

Response XML or HTML containing operation result. When using xml=Y result field indicates whether operation was successful (OK) or not (ERROR).

Example Response:

    
    
      OK
      Transformation [dummy-trans] stop requested.
      c56961b2-c848-49b8-abde-76c8015e29b0
    
    

Status Codes

code description
200 Request was processed.
500 Internal server error occurs during request processing.
*/ public void doGet( HttpServletRequest request, HttpServletResponse response ) throws ServletException, IOException { if ( isJettyMode() && !request.getContextPath().startsWith( CONTEXT_PATH ) ) { return; } if ( log.isDebug() ) { logDebug( BaseMessages.getString( PKG, "StopTransServlet.StopOfTransRequested" ) ); } String transName = request.getParameter( "name" ); String id = request.getParameter( "id" ); boolean inputOnly = "Y".equalsIgnoreCase( request.getParameter( "inputOnly" ) ); boolean useXML = "Y".equalsIgnoreCase( request.getParameter( "xml" ) ); PrintWriter out = response.getWriter(); try { if ( useXML ) { response.setContentType( "text/xml" ); response.setCharacterEncoding( Const.XML_ENCODING ); out.print( XMLHandler.getXMLHeader( Const.XML_ENCODING ) ); } else { response.setContentType( "text/html;charset=UTF-8" ); out.println( "" ); out.println( "" ); out.println( "" + BaseMessages.getString( PKG, "StopTransServlet.StopTrans" ) + "" ); out.println( "" ); out.println( "" ); out.println( "" ); out.println( "" ); } // ID is optional... // Trans trans; CarteObjectEntry entry; if ( Utils.isEmpty( id ) ) { // get the first transformation that matches... // entry = getTransformationMap().getFirstCarteObjectEntry( transName ); if ( entry == null ) { trans = null; } else { id = entry.getId(); trans = getTransformationMap().getTransformation( entry ); } } else { // Take the ID into account! // entry = new CarteObjectEntry( transName, id ); trans = getTransformationMap().getTransformation( entry ); } if ( trans != null ) { if ( inputOnly ) { trans.safeStop(); } else { trans.stopAll(); } String message = BaseMessages.getString( PKG, "StopTransServlet.TransSopRequested", transName ); if ( useXML ) { out.println( new WebResult( WebResult.STRING_OK, message, id ).getXML() ); } else { out.println( "

" + Encode.forHtml( message ) + "

" ); out.println( "" + BaseMessages.getString( PKG, "TransStatusServlet.BackToTransStatusPage" ) + "

" ); } } else { String message = BaseMessages.getString( PKG, "StopTransServlet.CanNotFindTrans", transName ); if ( useXML ) { out.println( new WebResult( WebResult.STRING_ERROR, message, id ).getXML() ); } else { out.println( "

" + Encode.forHtml( message ) + "

" ); out.println( "" + BaseMessages.getString( PKG, "TransStatusServlet.BackToStatusPage" ) + "

" ); response.setStatus( HttpServletResponse.SC_BAD_REQUEST ); } } } catch ( Exception ex ) { if ( useXML ) { out.println( new WebResult( WebResult.STRING_ERROR, Const.getStackTracker( ex ) ).getXML() ); } else { out.println( "

" ); out.println( "

" );
        out.println( Encode.forHtml( Const.getStackTracker( ex ) ) );
        out.println( "
" ); response.setStatus( HttpServletResponse.SC_BAD_REQUEST ); } } if ( !useXML ) { out.println( "

" ); out.println( "" ); out.println( "" ); } } public String toString() { return "Stop transformation"; } public String getService() { return CONTEXT_PATH + " (" + toString() + ")"; } public String getContextPath() { return CONTEXT_PATH; } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy