Fixes authentication issues

- avoids Weld injection exception when (authentication) servlet filter is
  run before a Faces context has been established
  (MissingConfigurationContextException) The mkjsf core itself has no
  such filter, but mk2jsf-demo has.
- avoids redirect to given app page on auth failure

Clean-up

Removes obsolete interface, obsolete class, obsolete methods

Adds support for parsing diff. expression operators

.. and for removing expressions for a field by supplying empty value

Adds generic filter logic, target-filter logic obsolete

Adds methods handling 'filter' and 'limit' expressions

Renames method. Javadoc.

Moves UI convenience methods to UiUtils class

Object exposed to JSF pages as 'pzui'

Adds convenience methods for UI pages

Renames one method and add others for conveniently getting data
from response data objects.

Adds utility method for concatenating strings in EL expressions
(no such built-in function in JSF EL)

Adds more 'standard' fields to hit data object

Fixes bug in return of non-record XML response

Fixes termlist command parameter bug

Tentatively adds JSF navigation method

Moves init doc upload to InitCommandSp (sp ext of init)

.. effectively making ServiceProxyExtensions bean and interface obsolete

Adds rank parameter to show command

Merge branch 'master' of ssh://git.indexdata.com/home/git/private/mkjsf

Renames Pz2Bean to Pz2Service

Name exposed to UI is still just 'pz2'

Renames Pz2Bean to Pz2Service

Name exposes to UI is still just 'pz2'

Cleans up SP extension commands

.. as for straight pz2 commands, request logic is moved from the main
SP extensions bean into individual commands.

Also adds options (pz2 and sp) for adding service command parameters as
parameters to the run() command itself.
Useful for this approach in a form: <submit action="auth.run('action=login')">

Reduces logging

Moves request logic from pz2bean to individual commands

Simplifies the main bean and makes command execution from UI
more intuitive

Refactors commands and injection

Trying to have command execute themselves (rather than pz2bean
executing them) by giving them the request environment. That caused
problems with injection - complex injection graphs and dependencies
that were null at first use, so refactors this as well.

Adds checks for unsupported commands

Avoids running unsupported 'categories' repeatedly.
Warns in log about unsupported 'auth' command.

Adds distinction between pz2 and sp errors

.. and checks for SP command fall-through to Pazpar2 (unsupported SP commands)

Renames variable

Creates SP response data object

.. for the purpose of detecting unsupported SP commands on execution

Adds mergekey parameter to search and show

Adds support for rank parameter on search command

Further reducing auth code

Cleans up auth logic

  Removes special classes (ie ServiceProxyUser) and associated
  method calls for auth logic, basically treating the auth commands
  more like any other commands.

Organizes SP specific responses in separate class

Also: introduces reset-levels:
      all from search and beyond
      all fron init and beyond
      all from auth and beyond
for clarity when switching service URL's and service IDs

Moves Auth response class to SP data package

Adds check for SP only commands.

Also:
 Adds support for setting Pazpar2 service ID
 Tweaks log levels

Adds support for downloading binary record response

Documentation

Bugfixes for browser history management. Documentation.

Tweak to support for state mgmt across xhtml pages

Excludes auth info from state key.

Hacks login method to make mk2jsf demo work for now.

Logs missing client type decision (SP/PZ2) when searching.

Attempts to fix state handling accross XHTML pages.

Approach may also handle UI generated locationhashes - to be seen though.

Removes timing from thread object

Not all commands routed through this class anymore.

Removes last piece of business logic from thread object

.. making a purely technical class, just for executing pz2 requests
   asynchronously

Fixes missing search command instruction to pz2 client

Adds support for target category command - 'categories'

.. includes some further work on the disentanglement of the
logic/methods for different types of commands

Fixes err msg bug. Adds status field to error xml.

Fixes bug that failed to write error xml for pazpar2 417.
Adds status field to error xml so the ui can do, say,
search.status=='OK' even in case of a search error response.

Disentangles update() logic. Adds option for early feedback.

'search' and 'record' commands are disentangled from the general update()
logic, in particular there is no longer recursion into update() in cases
where a 'search' is needed before a 'show', say. Dedicated doSearch and
doRecord methods are added with the intention of clarifying things.

Also adds an option for feedback right after 'search' returns, by having
update(show,stat,bytarget,termlist) skip processing on the first
round-trip. The UI thus have a change to detect that a search has started
and notify the user (before it would need to wait for the first update of
show,stat,.. etc). For setups with dozens or even hundreds of targets the
wait for the first sign of activity can otherwise be many seconds.

Gets the greater activeclients from stat or show

.. to keep polling until they are in synch

Merge branch 'master' of ssh://git.indexdata.com/home/git/private/mkjsf

Conflicts:
src/main/java/com/indexdata/mkjsf/pazpar2/Pz2Bean.java

Prevents automatic show,stat,.. updates on search errors

Prevents automatic show,stat,.. updates on search errors

Tweaks error catching and messages.

Tries to pick up wrong Pazpar2 address errors for errxml

For the search command those are hidden in masterkey commons pz2client
 under a generic "cannot parse session id".

For other commands it can come back in various shapes and forms -
 for instance as a HTML page with domain name adds.

More error handling/reporting. Normalizing auth resp

Parses HTML reponses where XML were expected, for instance HTML pages
returned when domain is not found or HTML error pages from servlet
container when service-proxy app not found.

Also normalizes auth responses, renaming the document element 'response'
to 'auth' before handing the XML string to the parser (other responses
are named by their corresponding command, which is what the parser
expects). Thie original auth response is still preserved, though.

Cleans up SP auth, parse resps, store for display, etc

Catches init doc upload errors

.. embeds them in init reponse, i.e. for display in UI

Adds option to download any command respond

.. changes init doc response download to use generic download method

Tweaks init command and init doc submission.

Makes submitting SP init docs available directly on "pz2x"
(SP extension bean) and puts the init response into the regular
flow of processing for display as any other response.

Makes it optional to reset the init response when resetting
search/record/show data. As before, search data are reset on renewed
search or when the server or authentication changes. Init response
is now only reset on changed init (whether it happens implicit or
explicit).

Renames variable

Picks up more info for ajax error alert box

Fixes some log levels, typos.

Renames data classes that are no longer pz2 only

.. to reflect that they handle SP-only responses too

Adds init response data object

Changes response object naming

.. to better distinguish between the simple http response wrapper
and the SAX parsed response data objects

Tweaks configuration, command responses, pz2/sp switching

Generalizes method for retrieving char separated config properties
Consolidates command responses in one common class for sp an pz2 clients
Fixes switches of service urls for pz2 url to sp url and vice versa

Adds support for chosing pz2 or sp service run-time

The client type as well as the service url can thus be
changed dynamically.

Defining service type deploy time is now done by a config parameter -
rather than -- as it used to be -- by setting an injection instruction
in beans.xml.

Fixes comment typo

Generalizes file upload function and moves it into core

Rearranges pz2/sp client logic to isolate error messaging

Error message handling and generating consolidated and put in one
place (for each of pz2 and sp).

Is put in client.executeCommand, which no longer throws exceptions -
all errors client errors sought captured here and converted to XML
responses, thus simplifying things for the users of executeCommand.

Exposing location checksums and offsets to ui/client

Tweaks logs

Clears requests and responses on new ip auth

Adds methods for displaying authentication status

Makes all stats ints (except progress)

Adds support for show-block

Tweaks IP authentication

Adds support for record checksum

Makes init doc debug response optional

Adds option to configure multiple SP URLs

For selecting an SP runtime from pre-configured list.

Adds support for offset and binary parameters

Thus support for handling unknow document types. Still lacks option to
show binary response.

Clears user info when changing service URL

Adds to debug info regarding activeclients

Adds support for 'acefilter' parameter to record command

Do record despite no previous search IF it has recordquery.

And defaults UI accessible serviceProxyUrl from config

Adds SP extensions to Pazpar2 commands and parameters

Adds remaining command parameters ref. Pazpar2 protocol doc.

Adds error listener to alert user. Formats code.

Fixes NPE causing page to fail on facet being absent

Attempts to avoid passivation errors due to http-client

Adds some debug log statements for target filter

Adds IP authentication to SP client

Changes project title and description.

Adds demo auth method. Tweaks polling & state fields setup.

Adds a method for automatic authentication from demo.

Tweaks naming and location for specialty fields for pazpar2 polling
and browser history handling.

Renames pz2utils4jsf package to mkjsf

Renames project from pz2utils4jsf to mkjsf

Sets up error central. Lets page author decide to show.

Creates a separate error container, exposed to the Faces pages as 'errors'.

The page author decides whether and where to show errors, which so
far come in two categories: configuration errors and request errors.

Various fixes, clean-up, logs, documentation

 Reinstates error helper that went missing during refactoring

 Removes XML declaration from pazpar2 error responses in order to
 inject the XML itself into an application error XML document.

 Straightens some log statements

 Moves WELD-001303 error documentation aside (as it is not relevant
 with current approach)

Fixes error object reference

Simplifies state handling further

Postpones cloning of a command to the time when it's actually modified,
then pushes it to the state handler transparently.
Obviates the need to checkout a command for modification vs.
getting it read-only.
Recently introduced CommandReadOnly interface is consequently dropped again.

Ammends some fringe scenarios with state keys and states

.. also makes state key a hashcode - to shorten it and because the
   textual key would often not seem quite accurate - even though it
   would accurately fetch the correct state -- and thus could cause
   confusion for one inspecting it

Fixes missing subscription to state changes by SP bean