**** CubicPower OpenStack Study ****
# Copyright 2011 OpenStack Foundation
# All Rights Reserved.
#
# Licensed 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.
"""
Controller for Image Cache Management API
"""
import webob.exc
from glance.api import policy
from glance.api.v1 import controller
from glance.common import exception
from glance.common import wsgi
from glance import image_cache
**** CubicPower OpenStack Study ****
class Controller(controller.BaseController):
"""
A controller for managing cached images.
"""
**** CubicPower OpenStack Study ****
def __init__(self):
self.cache = image_cache.ImageCache()
self.policy = policy.Enforcer()
**** CubicPower OpenStack Study ****
def _enforce(self, req):
"""Authorize request against 'manage_image_cache' policy"""
try:
self.policy.enforce(req.context, 'manage_image_cache', {})
except exception.Forbidden:
raise webob.exc.HTTPForbidden()
**** CubicPower OpenStack Study ****
def get_cached_images(self, req):
"""
GET /cached_images
Returns a mapping of records about cached images.
"""
self._enforce(req)
images = self.cache.get_cached_images()
return dict(cached_images=images)
**** CubicPower OpenStack Study ****
def delete_cached_image(self, req, image_id):
"""
DELETE /cached_images/ Removes an image from the cache.
"""
self._enforce(req)
self.cache.delete_cached_image(image_id)
**** CubicPower OpenStack Study ****
def delete_cached_images(self, req):
"""
DELETE /cached_images - Clear all active cached images
Removes all images from the cache.
"""
self._enforce(req)
return dict(num_deleted=self.cache.delete_all_cached_images())
**** CubicPower OpenStack Study ****
def get_queued_images(self, req):
"""
GET /queued_images
Returns a mapping of records about queued images.
"""
self._enforce(req)
images = self.cache.get_queued_images()
return dict(queued_images=images)
**** CubicPower OpenStack Study ****
def queue_image(self, req, image_id):
"""
PUT /queued_images/ Queues an image for caching. We do not check to see if
the image is in the registry here. That is done by the
prefetcher...
"""
self._enforce(req)
self.cache.queue_image(image_id)
**** CubicPower OpenStack Study ****
def delete_queued_image(self, req, image_id):
"""
DELETE /queued_images/ Removes an image from the cache.
"""
self._enforce(req)
self.cache.delete_queued_image(image_id)
**** CubicPower OpenStack Study ****
def delete_queued_images(self, req):
"""
DELETE /queued_images - Clear all active queued images
Removes all images from the cache.
"""
self._enforce(req)
return dict(num_deleted=self.cache.delete_all_queued_images())
**** CubicPower OpenStack Study ****
class CachedImageDeserializer(wsgi.JSONRequestDeserializer):
pass
**** CubicPower OpenStack Study ****
class CachedImageSerializer(wsgi.JSONResponseSerializer):
pass
**** CubicPower OpenStack Study ****
def create_resource():
"""Cached Images resource factory method"""
deserializer = CachedImageDeserializer()
serializer = CachedImageSerializer()
return wsgi.Resource(Controller(), deserializer, serializer)