/**
* Provisions all web applications.
*
* @param \AppserverIo\Psr\Application\ApplicationInterface $application The application instance
*
* @return void
*/
public function provision(ApplicationInterface $application)
{
// check if the webapps directory exists
if (is_dir($webappPath = $application->getWebappPath())) {
// prepare the glob expression with the application's directories to parse
$applicationDirectories = AppEnvironmentHelper::getEnvironmentAwareGlobPattern($webappPath, '{WEB-INF,META-INF}/provision', GLOB_BRACE);
// load the service instance
/** @var \AppserverIo\Appserver\Core\Api\ProvisioningService $service */
$service = $this->getService();
// load the configuration service instance
/** @var \AppserverIo\Appserver\Core\Api\ConfigurationService $configurationService */
$configurationService = $this->getInitialContext()->newService('AppserverIo\\Appserver\\Core\\Api\\ConfigurationService');
// load the container node to initialize the system properties
/** @var \AppserverIo\Appserver\Core\Api\Node\ContainerNodeInterface $containerNode */
$containerNode = $application->getContainer()->getContainerNode();
// iterate through all provisioning files (provision.xml), validate them and attach them to the configuration
foreach ($service->globDir($applicationDirectories, GLOB_BRACE) as $provisionFile) {
try {
// validate the file, but skip it if the validation fails
$configurationService->validateFile($provisionFile, null);
// load the system properties
$properties = $service->getSystemProperties($containerNode);
// append the application specific properties
$properties->add(SystemPropertyKeys::WEBAPP, $webappPath);
$properties->add(SystemPropertyKeys::WEBAPP_NAME, basename($webappPath));
$properties->add(SystemPropertyKeys::WEBAPP_CACHE, $application->getCacheDir());
$properties->add(SystemPropertyKeys::WEBAPP_SESSION, $application->getSessionDir());
// create a new provision node instance and replace the properties
$provisionNode = new ProvisionNode();
$provisionNode->initFromFile($provisionFile);
$provisionNode->replaceProperties($properties);
// query whether we've a datasource configured or not
if ($datasource = $provisionNode->getDatasource()) {
// try to load the datasource from the system configuration
$datasourceNode = $service->findByName($datasource->getName());
// try to inject the datasource node if available
if ($datasourceNode != null) {
$provisionNode->injectDatasource($datasourceNode);
}
}
/* Re-provision the provision.xml (reinitialize).
*
* ATTENTION: The re-provisioning is extremely important, because
* this allows dynamic replacement of placeholders by using the
* XML file as a template that will reinterpreted with the PHP
* interpreter!
*/
$provisionNode->reprovision($provisionFile);
// execute the provisioning workflow
$this->executeProvision($application, $provisionNode, new \SplFileInfo($webappPath));
} catch (ConfigurationException $ce) {
// load the logger and log the XML validation errors
$systemLogger = $this->getInitialContext()->getSystemLogger();
$systemLogger->error($ce->__toString());
// additionally log a message that DS will be missing
$systemLogger->critical(sprintf('Will skip reading provisioning steps in %s, provisioning might not have been done.', $provisionFile));
}
}
}
}
/**
* Registers the entity managers at startup.
*
* @param \AppserverIo\Psr\Application\ApplicationInterface $application The application instance
*
* @return void
*/
public function registerEntityManagers(ApplicationInterface $application)
{
// build up META-INF directory var
$metaInfDir = $this->getWebappPath() . DIRECTORY_SEPARATOR . 'META-INF';
// check if we've found a valid directory
if (is_dir($metaInfDir) === false) {
return;
}
// check META-INF + subdirectories for XML files with MQ definitions
/** @var \AppserverIo\Appserver\Core\Api\DeploymentService $service */
$service = $application->newService('AppserverIo\\Appserver\\Core\\Api\\DeploymentService');
$xmlFiles = $service->globDir(AppEnvironmentHelper::getEnvironmentAwareGlobPattern($this->getWebappPath(), 'META-INF' . DIRECTORY_SEPARATOR . 'persistence'));
// load the configuration service instance
/** @var \AppserverIo\Appserver\Core\Api\ConfigurationService $configurationService */
$configurationService = $application->newService('AppserverIo\\Appserver\\Core\\Api\\ConfigurationService');
// load the container node to initialize the system properties
/** @var \AppserverIo\Appserver\Core\Api\Node\ContainerNodeInterface $containerNode */
$containerNode = $application->getContainer()->getContainerNode();
// gather all the deployed web applications
foreach ($xmlFiles as $file) {
try {
// validate the file here, but skip if the validation fails
$configurationService->validateFile($file, null, true);
// load the system properties
$properties = $service->getSystemProperties($containerNode);
// append the application specific properties
$properties->add(SystemPropertyKeys::WEBAPP, $webappPath = $application->getWebappPath());
$properties->add(SystemPropertyKeys::WEBAPP_NAME, basename($webappPath));
$properties->add(SystemPropertyKeys::WEBAPP_CACHE, $application->getCacheDir());
$properties->add(SystemPropertyKeys::WEBAPP_SESSION, $application->getSessionDir());
// create a new persistence manager node instance and replace the properties
$persistenceNode = new PersistenceNode();
$persistenceNode->initFromFile($file);
$persistenceNode->replaceProperties($properties);
// register the entity managers found in the configuration
foreach ($persistenceNode->getPersistenceUnits() as $persistenceUnitNode) {
$this->registerEntityManager($application, $persistenceUnitNode);
}
} catch (InvalidConfigurationException $e) {
// try to load the system logger instance
/** @var \Psr\Log\LoggerInterface $systemLogger */
if ($systemLogger = $this->getApplication()->getInitialContext()->getSystemLogger()) {
$systemLogger->error($e->getMessage());
$systemLogger->critical(sprintf('Persistence configuration file %s is invalid, needed entity managers might be missing.', $file));
}
} catch (\Exception $e) {
// try to load the system logger instance
/** @var \Psr\Log\LoggerInterface $systemLogger */
if ($systemLogger = $this->getApplication()->getInitialContext()->getSystemLogger()) {
$systemLogger->error($e->__toString());
}
}
}
}
/**
* Initializes the session manager.
*
* @param \AppserverIo\Psr\Application\ApplicationInterface $application The application instance
*
* @return void
* @see \AppserverIo\Psr\Application\ManagerInterface::initialize()
*/
public function initialize(ApplicationInterface $application)
{
// load the servlet manager with the session settings configured in web.xml
/** @var \AppserverIo\Psr\Servlet\ServletContextInterface|\AppserverIo\Psr\Application\ManagerInterface $servletManager */
$servletManager = $application->search('ServletContextInterface');
// load the settings, set the default session save path
$sessionSettings = $this->getSessionSettings();
$sessionSettings->setSessionSavePath($application->getSessionDir());
// if we've session parameters defined in our servlet context
if ($servletManager->hasSessionParameters()) {
// we want to merge the session settings from the servlet context
$sessionSettings->mergeServletContext($servletManager);
}
// initialize the garbage collector and the persistence manager
$this->getGarbageCollector()->initialize();
$this->getPersistenceManager()->initialize();
}
/**
* Creates the temporary directory for the webapp.
*
* @param \AppserverIo\Psr\Application\ApplicationInterface $application The application to create the temporary directories for
*
* @return void
*/
public function createTmpFolders(ApplicationInterface $application)
{
// create the directory we want to store the sessions in
$tmpFolders = array(new \SplFileInfo($application->getTmpDir()), new \SplFileInfo($application->getCacheDir()), new \SplFileInfo($application->getSessionDir()));
// create the applications temporary directories
foreach ($tmpFolders as $tmpFolder) {
$this->createDirectory($tmpFolder);
}
}
/**
* Initializes the session manager.
*
* @param \AppserverIo\Psr\Application\ApplicationInterface $application The application instance
*
* @return void
* @see \AppserverIo\Psr\Application\ManagerInterface::initialize()
*/
public function initialize(ApplicationInterface $application)
{
// load the servlet manager with the session settings configured in web.xml
/** @var \AppserverIo\Psr\Servlet\ServletContextInterface|\AppserverIo\Psr\Application\ManagerInterface $servletManager */
$servletManager = $application->search(ServletContextInterface::IDENTIFIER);
// load the settings, set the default session save path
$sessionSettings = $this->getSessionSettings();
$sessionSettings->setSessionSavePath($application->getSessionDir());
// if we've session parameters defined in our servlet context
if ($servletManager->hasSessionParameters()) {
// we want to merge the session settings from the servlet context
$sessionSettings->mergeServletContext($servletManager);
}
}