@Override
    public void setDocumentLocator(final Locator locator) {
        this.locator = locator;
        super.setDocumentLocator(this);
    }
This method tells filters that a stream is about to be parsed so that
they can complete any setup necessary.
stroom-pipeline/src/main/java/stroom/pipeline/filter/ResultLocator.java