Skip to content

Commit

Permalink
Merge pull request #7378 from pblottiere/server_doc
Browse files Browse the repository at this point in the history
[server] Update doc path for server
  • Loading branch information
pblottiere authored Jul 13, 2018
2 parents 48195e0 + dcb86a0 commit bf56bd3
Show file tree
Hide file tree
Showing 47 changed files with 465 additions and 674 deletions.
2 changes: 1 addition & 1 deletion .ci/travis/code_layout/install.sh
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,6 @@ export CORES=2
mkdir build
pushd build || exit

cmake -DUSE_CCACHE=OFF -DWITH_CORE=OFF -DWITH_APIDOC=ON -DWITH_ASTYLE=ON -DENABLE_TESTS=ON ..
cmake -DWITH_SERVER=ON -DUSE_CCACHE=OFF -DWITH_CORE=OFF -DWITH_APIDOC=ON -DWITH_ASTYLE=ON -DENABLE_TESTS=ON ..

popd || exit
21 changes: 7 additions & 14 deletions doc/CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -104,23 +104,16 @@ IF(WITH_APIDOC)
${CMAKE_SOURCE_DIR}/src/quickgui/plugin
)

IF(WITH_SERVER_PLUGINS)
IF(WITH_SERVER)
SET(DOXYGEN_INPUT
${DOXYGEN_INPUT}
${CMAKE_SOURCE_DIR}/src/server/qgsserver.h
${CMAKE_SOURCE_DIR}/src/server/qgscapabilitiescache.h
${CMAKE_SOURCE_DIR}/src/server/qgsserverexception.h
${CMAKE_SOURCE_DIR}/src/server/qgsrequesthandler.h
${CMAKE_SOURCE_DIR}/src/server/qgsserverfilter.h
${CMAKE_SOURCE_DIR}/src/server/qgsaccesscontrolfilter.h
${CMAKE_SOURCE_DIR}/src/server/qgsserverinterface.h
${CMAKE_SOURCE_DIR}/src/server/qgsserverrequest.h
${CMAKE_SOURCE_DIR}/src/server/qgsserverresponse.h
${CMAKE_SOURCE_DIR}/src/server/qgsserverrequest.h
${CMAKE_SOURCE_DIR}/src/server/qgsservice.h
${CMAKE_SOURCE_DIR}/src/server/qgsserviceregistry.h
${CMAKE_SOURCE_DIR}/src/server/
${CMAKE_SOURCE_DIR}/src/server/services/
${CMAKE_SOURCE_DIR}/src/server/services/wms
${CMAKE_SOURCE_DIR}/src/server/services/wfs
${CMAKE_SOURCE_DIR}/src/server/services/wcs
)
ENDIF(WITH_SERVER_PLUGINS)
ENDIF(WITH_SERVER)

SET(DOXYGEN_FILE_PATTERNS *.h *.cpp *.dox)

Expand Down
5 changes: 3 additions & 2 deletions python/server/auto_generated/qgsaccesscontrol.sip.in
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,9 @@
class QgsAccessControl : QgsFeatureFilterProvider
{
%Docstring
A helper class that centralize the restrictions given by all the
access control filter plugins.
A helper class that centralizes restrictions given by all the access control filter plugins.

.. versionadded:: 2.14
%End

%TypeHeaderCode
Expand Down
5 changes: 3 additions & 2 deletions python/server/auto_generated/qgsbufferserverrequest.sip.in
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,9 @@
class QgsBufferServerRequest : QgsServerRequest
{
%Docstring
QgsBufferServerRequest
Class defining request with data
Class defining request with data

.. versionadded:: 3.0
%End

%TypeHeaderCode
Expand Down
2 changes: 2 additions & 0 deletions python/server/auto_generated/qgsbufferserverresponse.sip.in
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,8 @@ class QgsBufferServerResponse: QgsServerResponse
{
%Docstring
Class defining buffered response

.. versionadded:: 3.0
%End

%TypeHeaderCode
Expand Down
13 changes: 12 additions & 1 deletion python/server/auto_generated/qgsconfigcache.sip.in
Original file line number Diff line number Diff line change
Expand Up @@ -15,19 +15,30 @@ class QgsConfigCache : QObject
{
%Docstring
Cache for server configuration.

.. versionadded:: 2.8
%End

%TypeHeaderCode
#include "qgsconfigcache.h"
%End
public:

static QgsConfigCache *instance();
%Docstring
Returns the current instance.
%End

void removeEntry( const QString &path );
%Docstring
Removes an entry from cache.

:param path: The path of the project
%End

const QgsProject *project( const QString &path );
%Docstring
If the project is not cached yet, then the project is read thank to the
If the project is not cached yet, then the project is read thanks to the
path. If the project is not available, then a None is returned.

:param path: the filename of the QGIS project
Expand Down
7 changes: 7 additions & 0 deletions python/server/auto_generated/qgsmapserviceexception.sip.in
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,14 @@ The most important codes are:
#include "qgsmapserviceexception.h"
%End
public:

QgsMapServiceException( const QString &code, const QString &message );
%Docstring
Constructor for QgsMapServiceException.

:param code: HTTP error code
:param message: Exception message to return to the client
%End
};

/************************************************************************
Expand Down
3 changes: 1 addition & 2 deletions python/server/auto_generated/qgsserversettings.sip.in
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,7 @@
class QgsServerSettings
{
%Docstring
QgsServerSettings provides a way to retrieve settings by prioritizing
according to environment variables, ini file and default values.
Provides a way to retrieve settings by prioritizing according to environment variables, ini file and default values.

.. versionadded:: 3.0
%End
Expand Down
16 changes: 9 additions & 7 deletions python/server/auto_generated/qgsservicemodule.sip.in
Original file line number Diff line number Diff line change
Expand Up @@ -14,12 +14,14 @@
class QgsServiceModule
{
%Docstring
QgsServiceModule
Class defining the service module interface for QGIS server services

This class acts as a service registrar for services.

For dynamic modules, a QgsServiceModule instance is returned from the QGS_ServiceModule_Init() entry point
For dynamic modules, a QgsServiceModule instance is returned from the
QGS_ServiceModule_Init() entry point.

.. versionadded:: 3.0
%End

%TypeHeaderCode
Expand All @@ -29,21 +31,21 @@ For dynamic modules, a QgsServiceModule instance is returned from the QGS_Servic

QgsServiceModule();
%Docstring
Constructor
Default constructor for QgsServiceModule.
%End

virtual ~QgsServiceModule() = 0;
virtual ~QgsServiceModule();

virtual void registerSelf( QgsServiceRegistry &registry,
QgsServerInterface *serverIface = 0 ) = 0;
%Docstring
Ask module to register all provided services
Asks the module to register all provided services.

:param registry: :py:class:`QgsServiceRegistry`
:param registry: Service registry
:param serverIface: Interface for plugins
%End
};


/************************************************************************
* This file has been generated automatically from *
* *
Expand Down
2 changes: 1 addition & 1 deletion python/server/server_auto.sip
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// Include auto-generated SIP files
%Include auto_generated/qgsservicemodule.sip
%Include auto_generated/qgsmapserviceexception.sip
%Include auto_generated/qgscapabilitiescache.sip
%Include auto_generated/qgsconfigcache.sip
Expand All @@ -15,7 +16,6 @@
%Include auto_generated/qgsserverrequest.sip
%Include auto_generated/qgsserverresponse.sip
%Include auto_generated/qgsservice.sip
%Include auto_generated/qgsservicemodule.sip
%Include auto_generated/qgsserviceregistry.sip
%Include auto_generated/qgsfeaturefilterprovidergroup.sip
%Include auto_generated/qgsfeaturefilter.sip
Expand Down
3 changes: 1 addition & 2 deletions src/server/CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,6 @@ SET(QGIS_SERVER_SRCS
qgsbufferserverresponse.cpp
qgscapabilitiescache.cpp
qgsconfigcache.cpp
qgsconfigparserutils.cpp
qgsfcgiserverrequest.cpp
qgsfcgiserverresponse.cpp
qgsfilterresponsedecorator.cpp
Expand All @@ -40,14 +39,14 @@ SET(QGIS_SERVER_SRCS
qgsserverresponse.cpp
qgsserversettings.cpp
qgsservice.cpp
qgsservicemodule.cpp
qgsservicenativeloader.cpp
qgsserviceregistry.cpp
qgsfeaturefilterprovidergroup.cpp
qgsfeaturefilter.cpp
)

SET (QGIS_SERVER_HDRS
qgsservicemodule.h
qgsmapserviceexception.h
)

Expand Down
6 changes: 3 additions & 3 deletions src/server/qgsaccesscontrol.h
Original file line number Diff line number Diff line change
Expand Up @@ -33,9 +33,9 @@ class QgsAccessControlPlugin;
/**
* \ingroup server
* \class QgsAccessControl
* \brief A helper class that centralize the restrictions given by all the
* access control filter plugins.
**/
* \brief A helper class that centralizes restrictions given by all the access control filter plugins.
* \since QGIS 2.14
*/
class SERVER_EXPORT QgsAccessControl : public QgsFeatureFilterProvider
{
#ifdef SIP_RUN
Expand Down
5 changes: 3 additions & 2 deletions src/server/qgsbufferserverrequest.h
Original file line number Diff line number Diff line change
Expand Up @@ -28,8 +28,9 @@

/**
* \ingroup server
* QgsBufferServerRequest
* Class defining request with data
* \class QgsBufferServerRequest
* \brief Class defining request with data
* \since QGIS 3.0
*/
class SERVER_EXPORT QgsBufferServerRequest : public QgsServerRequest
{
Expand Down
3 changes: 2 additions & 1 deletion src/server/qgsbufferserverresponse.h
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,8 @@
/**
* \ingroup server
* \class QgsBufferServerResponse
* Class defining buffered response
* \brief Class defining buffered response
* \since QGIS 3.0
*/
class SERVER_EXPORT QgsBufferServerResponse: public QgsServerResponse
{
Expand Down
15 changes: 12 additions & 3 deletions src/server/qgsconfigcache.h
Original file line number Diff line number Diff line change
Expand Up @@ -31,20 +31,29 @@
#include "qgsproject.h"

/**
* Cache for server configuration.
* \ingroup server
* \brief Cache for server configuration.
* \since QGIS 2.8
*/
class SERVER_EXPORT QgsConfigCache : public QObject
{
Q_OBJECT
public:

/**
* Returns the current instance.
*/
static QgsConfigCache *instance();

/**
* Removes an entry from cache.
* \param path The path of the project
*/
void removeEntry( const QString &path );

/**
* If the project is not cached yet, then the project is read thank to the
* path. If the project is not available, then a nullptr is returned.
* If the project is not cached yet, then the project is read thanks to the
* path. If the project is not available, then a nullptr is returned.
* \param path the filename of the QGIS project
* \returns the project or nullptr if an error happened
* \since QGIS 3.0
Expand Down
Loading

0 comments on commit bf56bd3

Please sign in to comment.