proxy/StatPages.h

/** @file

  A brief file description

  @section license License

  Licensed to the Apache Software Foundation (ASF) under one
  or more contributor license agreements.  See the NOTICE file
  distributed with this work for additional information
  regarding copyright ownership.  The ASF licenses this file
  to you 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.
 */

/****************************************************************************

  StatPages.h


 ****************************************************************************/

#ifndef _StatPages_h_
#define _StatPages_h_
#include "P_EventSystem.h"

#include "HTTP.h"

//              SPECIAL URLs
//
//
// 1. Access from Browswers
//
//    By special URLS:
//
//      http://{module}/component/sub-component/request-type?arguments
//
//    Note how the hostname is the module to be queried with "{}" surrounding.
//
//    Running Example:
//
//      http://{http}/groups/dump?comp.compilers
//
// 2. What sort of things should be available?
//
//    A. The type of data should default to HTML or match the
//       extension type e.g.:
//
//         http://{http}/groups/use_graph.gif?august
//
//    B. Each protocol/sybsystem should have their own information.
//       For example

#define STAT_PAGE_SUCCESS           STAT_PAGES_EVENTS_START+0
#define STAT_PAGE_FAILURE           STAT_PAGES_EVENTS_START+1

typedef Action *(*StatPagesFunc) (Continuation * cont, HTTPHdr * header);

struct StatPageData
{
  char *data;
  char *type;
  int length;

    StatPageData():data(NULL), type(NULL), length(0)
  {
  }
  StatPageData(char *adata):data(adata), type(NULL)
  {
    length = strlen(adata);
  }
  StatPageData(char *adata, int alength):data(adata), type(NULL), length(alength)
  {
  }
};

struct StatPagesManager
{
  void init();

  inkcoreapi void register_http(const char *hostname, StatPagesFunc func);

  // Private
  Action *handle_http(Continuation * cont, HTTPHdr * header);
  bool is_stat_page(URL * url);
  bool is_cache_inspector_page(URL * url);
  int m_enabled;
};

inkcoreapi extern StatPagesManager statPagesManager;

// Stole Pete's code for formatting the page and slapped it here
//   for easy reuse
class BaseStatPagesHandler:public Continuation
{
public:
  BaseStatPagesHandler(ProxyMutex * amutex):Continuation(amutex), response(NULL), response_size(0), response_length(0)
  {
  };
  ~BaseStatPagesHandler() {
    resp_clear();
  };

protected:

  inkcoreapi void resp_clear(void);
  inkcoreapi void resp_add(const char *fmt, ...);
  inkcoreapi void resp_add_sep(void);
  inkcoreapi void resp_begin(const char *title);
  inkcoreapi void resp_end(void);
  void resp_begin_numbered(void);
  void resp_end_numbered(void);
  inkcoreapi void resp_begin_unnumbered(void);
  inkcoreapi void resp_end_unnumbered(void);
  inkcoreapi void resp_begin_item(void);
  void resp_end_item(void);
  inkcoreapi void resp_begin_table(int border, int columns, int percent);
  inkcoreapi void resp_end_table();
  inkcoreapi void resp_begin_row();
  inkcoreapi void resp_end_row();
  inkcoreapi void resp_begin_column(int percent = -1, const char *align = NULL);
  inkcoreapi void resp_end_column();

  char *response;
  int response_size;
  int response_length;
};

#endif