KTextTemplate::CachingLoaderDecorator

Search for usage in LXR

KTextTemplate::CachingLoaderDecorator Class Reference

#include <KTextTemplate/CachingLoaderDecorator>

Inheritance diagram for KTextTemplate::CachingLoaderDecorator:

Public Member Functions

 CachingLoaderDecorator (QSharedPointer< AbstractTemplateLoader > loader)
 
 ~CachingLoaderDecorator () override
 
bool canLoadTemplate (const QString &name) const override
 
void clear ()
 
std::pair< QString, QStringgetMediaUri (const QString &fileName) const override
 
bool isEmpty () const
 
Template loadByName (const QString &name, const KTextTemplate::Engine *engine) const override
 
int size () const
 
- Public Member Functions inherited from KTextTemplate::AbstractTemplateLoader
virtual ~AbstractTemplateLoader ()
 

Detailed Description

Implements a loader decorator which caches compiled Template objects.

The CachingLoaderDecorator can be used with any implementation of KTextTemplate::AbstractTemplateLoader.

loader->setTemplateDirs({"/path/one", "/path/two"});
auto cache =
m_engine->addTemplateLoader( cache );
QSharedPointer< T > create(Args &&... args)

The effect is that templates do not need to be loaded from the filesystem and compiled into Template objects on each access, but may be returned from the cache instead.

This can be significant if loading Templates in a loop, or loading the same Template very often in an application.

<ul>
{% for item in list %}
<li>{% include "itemtemplate.html" %}</li>
{% endfor %}
</ul>

If the loading of Templates is a bottleneck in an application, it may make sense to use the caching decorator.

Author
Stephen Kelly steve.nosp@m.ire@.nosp@m.gmail.nosp@m..com

Definition at line 59 of file cachingloaderdecorator.h.

Constructor & Destructor Documentation

◆ CachingLoaderDecorator()

CachingLoaderDecorator::CachingLoaderDecorator ( QSharedPointer< AbstractTemplateLoader > loader)

Constructor.

Definition at line 35 of file cachingloaderdecorator.cpp.

◆ ~CachingLoaderDecorator()

CachingLoaderDecorator::~CachingLoaderDecorator ( )
override

Destructor.

Definition at line 40 of file cachingloaderdecorator.cpp.

Member Function Documentation

◆ canLoadTemplate()

bool CachingLoaderDecorator::canLoadTemplate ( const QString & name) const
overridevirtual

Return true if a Template identified by name exists and can be loaded.

Implements KTextTemplate::AbstractTemplateLoader.

Definition at line 45 of file cachingloaderdecorator.cpp.

◆ clear()

void CachingLoaderDecorator::clear ( )

Clears the Templates objects cached in the decorator.

Definition at line 51 of file cachingloaderdecorator.cpp.

◆ getMediaUri()

std::pair< QString, QString > CachingLoaderDecorator::getMediaUri ( const QString & fileName) const
overridevirtual

Return a complete URI for media identified by fileName.

Implements KTextTemplate::AbstractTemplateLoader.

Definition at line 69 of file cachingloaderdecorator.cpp.

◆ isEmpty()

bool CachingLoaderDecorator::isEmpty ( ) const

Returns whether the cache is empty.

Definition at line 63 of file cachingloaderdecorator.cpp.

◆ loadByName()

Template CachingLoaderDecorator::loadByName ( const QString & name,
const KTextTemplate::Engine * engine ) const
overridevirtual

Load a Template called name.

Return an invalid Template if no content by that name exists.

Implements KTextTemplate::AbstractTemplateLoader.

Definition at line 75 of file cachingloaderdecorator.cpp.

◆ size()

int CachingLoaderDecorator::size ( ) const

Returns the number of Template objects cached in the decorator.

Definition at line 57 of file cachingloaderdecorator.cpp.


The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Wed Nov 6 2024 12:15:06 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.