Filter

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> org >> apache >> jmeter >> protocol >> http >> util >> [ accesslog overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

Sourc code of org.apache.jmeter.protocol.http.util.accesslog.Filter

SOURCE |

Download org.apache.jmeter.protocol.http.util.accesslog.Filter

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.jmeter.protocol.http.util.accesslog
Interface Filter

All Known Implementing Classes:: LogFilter, SessionFilter

public interface Filter

Description:

Filter interface is designed to make it easier to use Access Logs for JMeter test plans. Normally, a person would have to clean a log file manually and create the JMeter requests. The access log parse utility uses the filter to include/exclude files by either file name or regular expression pattern.

It will also be used by HttpSamplers that use access logs. Using access logs is intended as a way to simulate production traffic. For functional testing, it is better to use the standard functional testing tools in JMeter. Using access logs can also reduce the amount of memory needed to run large test plans.

Version:: $Revision: 1.7.2.1 $ last updated $Date: 2005/08/17 15:02:26 $ Created on: Jun 26, 2003

Method Summary

void excludeFiles(java.lang.String[] filenames)
          Exclude all files in the array

void excludePattern(java.lang.String[] regexp)
          Exclude any log entry that contains the following regular expression pattern.

java.lang.String filter(java.lang.String text)
          In case the user wants to replace the file extension, log parsers should call this method.

void includeFiles(java.lang.String[] filenames)
          Include all files in the array.

void includePattern(java.lang.String[] regexp)
          Include any log entry that contains the following regular expression pattern.

boolean isFiltered(java.lang.String path, org.apache.jmeter.testelement.TestElement sampler)
          Log parser will call this method to see if a particular entry should be filtered or not.

void reset()
          Tell the filter when the parsing has reached the end of the log file and is about to begin again.

void setReplaceExtension(java.lang.String oldextension, java.lang.String newextension)

Method Detail

setReplaceExtension

public void setReplaceExtension(java.lang.String oldextension,
                                java.lang.String newextension)

includeFiles

public void includeFiles(java.lang.String[] filenames)

Include all files in the array.

excludeFiles

public void excludeFiles(java.lang.String[] filenames)

Exclude all files in the array

includePattern

public void includePattern(java.lang.String[] regexp)

Include any log entry that contains the following regular expression pattern.

excludePattern

public void excludePattern(java.lang.String[] regexp)

Exclude any log entry that contains the following regular expression pattern.

isFiltered

public boolean isFiltered(java.lang.String path,
                          org.apache.jmeter.testelement.TestElement sampler)

Log parser will call this method to see if a particular entry should be filtered or not.

filter

public java.lang.String filter(java.lang.String text)

In case the user wants to replace the file extension, log parsers should call this method. This is useful for regression test plans. If a website is migrating from one platform to another and the file extension changes, the filter provides an easy way to do it without spending a lot of time.

reset

public void reset()

Tell the filter when the parsing has reached the end of the log file and is about to begin again. Gives the filter a chance to adjust it's values, if needed.