org.pentaho.di.www.StartExecutionTransServlet Maven / Gradle / Ivy
Show all versions of kettle-engine Show documentation
/*! ******************************************************************************
*
* Pentaho Data Integration
*
* Copyright (C) 2002-2017 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.exception.KettleException;
import org.pentaho.di.core.xml.XMLHandler;
import org.pentaho.di.i18n.BaseMessages;
import org.pentaho.di.trans.Trans;
public class StartExecutionTransServlet extends BaseHttpServlet implements CartePluginInterface {
private static Class PKG = StartExecutionTransServlet.class; // for i18n purposes, needed by Translator2!!
private static final long serialVersionUID = 3634806745372015720L;
public static final String CONTEXT_PATH = "/kettle/startExec";
public StartExecutionTransServlet() {
}
public StartExecutionTransServlet( TransformationMap transformationMap ) {
super( transformationMap );
}
/**
/kettle/startExec
GET
Starts transformation. If the transformation is not ready, an error is returned.
Example Request:
GET /kettle/startExec/?name=dummy-trans&xml=Y
Parameters
name
description
type
name
Name of the transformation to be executed.
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 executed. This parameter is optional when xml=Y is used.
query, 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
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( "Start execution of transformation requested" );
}
response.setStatus( HttpServletResponse.SC_OK );
String transName = request.getParameter( "name" );
String id = request.getParameter( "id" );
boolean useXML = "Y".equalsIgnoreCase( request.getParameter( "xml" ) );
PrintWriter out = response.getWriter();
if ( useXML ) {
response.setContentType( "text/xml" );
out.print( XMLHandler.getXMLHeader( Const.XML_ENCODING ) );
} else {
response.setContentType( "text/html;charset=UTF-8" );
out.println( "" );
out.println( "" );
out.println( ""
+ BaseMessages.getString( PKG, "PrepareExecutionTransServlet.TransPrepareExecution" ) + " " );
out.println( "" );
out.println( "" );
out.println( "" );
out.println( "" );
}
try {
// 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 ( trans.isReadyToStart() ) {
startThreads( trans );
if ( useXML ) {
out.println( WebResult.OK.getXML() );
} else {
out
.println( "Transformation "
+ Encode.forHtml( "\'" + transName + "\'" ) + " has been executed.
" );
out.println( "Back to the transformation status page" );
}
} else {
String message =
"The specified transformation ["
+ transName + "] is not ready to be started. (Was not prepared for execution)";
if ( useXML ) {
out.println( new WebResult( WebResult.STRING_ERROR, message ) );
} else {
out.println( "
" + Encode.forHtml( message ) + "
" );
out.println( ""
+ BaseMessages.getString( PKG, "TransStatusServlet.BackToStatusPage" ) + "" );
}
}
} else {
if ( useXML ) {
out.println( new WebResult( WebResult.STRING_ERROR, BaseMessages.getString(
PKG, "TransStatusServlet.Log.CoundNotFindSpecTrans", transName ) ) );
} else {
out.println( "
"
+ Encode.forHtml( BaseMessages.getString(
PKG, "TransStatusServlet.Log.CoundNotFindTrans", transName ) ) + "
" );
out.println( ""
+ BaseMessages.getString( PKG, "TransStatusServlet.BackToStatusPage" ) + "" );
}
}
} catch ( Exception ex ) {
if ( useXML ) {
out.println( new WebResult(
WebResult.STRING_ERROR, "Unexpected error during transformation execution preparation:"
+ Const.CR + Const.getStackTracker( ex ) ) );
} else {
out.println( "
" );
out.println( "
" );
out.println( Encode.forHtml( Const.getStackTracker( ex ) ) );
out.println( "" );
}
}
if ( !useXML ) {
out.println( "" );
out.println( "" );
out.println( "" );
}
}
public String toString() {
return "Start transformation";
}
public String getService() {
return CONTEXT_PATH + " (" + toString() + ")";
}
protected void startThreads( Trans trans ) throws KettleException {
trans.startThreads();
}
public String getContextPath() {
return CONTEXT_PATH;
}
}