vas 0.4.0 → 1.0.0

data/README.md

@@ -37,7 +37,7 @@ A number of [examples](https://github.com/vFabric/vas-ruby-api/tree/master/examp
 
 ### Documentation
 
-You may also like to look at the [API documentation](http://rubydoc.info/gems/vas/0.3.0/frames).
+You may also like to look at the [API documentation](http://rubydoc.info/gems/vas/frames).
 
 ##Licence
 

data/lib/vas.rb

@@ -20,12 +20,15 @@ require 'net/https'
 require 'net/http/post/multipart'
 require 'vas/shared/resource'
 require 'vas/shared/collection'
+require 'vas/shared/deletable'
 require 'vas/shared/mutable_collection'
 require 'vas/shared/configuration'
 require 'vas/shared/groups'
 require 'vas/shared/installations'
 require 'vas/shared/installation_images'
-require 'vas/shared/pending_configuration'
+require 'vas/shared/live_configuration'
+require 'vas/shared/node_configuration'
+require 'vas/shared/pending_configurations'
 require 'vas/shared/security'
 require 'vas/shared/state_resource'
 require 'vas/shared/instance'
@@ -36,6 +39,7 @@ require 'vas/gemfire/agent_instances'
 require 'vas/gemfire/agent_live_configurations'
 require 'vas/gemfire/agent_logs'
 require 'vas/gemfire/agent_node_instances'
+require 'vas/gemfire/agent_node_live_configurations'
 require 'vas/gemfire/agent_pending_configurations'
 require 'vas/gemfire/application_code_images'
 require 'vas/gemfire/application_code'
@@ -43,6 +47,7 @@ require 'vas/gemfire/cache_server_instances'
 require 'vas/gemfire/cache_server_live_configurations'
 require 'vas/gemfire/cache_server_logs'
 require 'vas/gemfire/cache_server_node_instances'
+require 'vas/gemfire/cache_server_node_live_configurations'
 require 'vas/gemfire/cache_server_pending_configurations'
 require 'vas/gemfire/disk_stores'
 require 'vas/gemfire/gemfire'
@@ -54,6 +59,7 @@ require 'vas/gemfire/locator_instances'
 require 'vas/gemfire/locator_live_configurations'
 require 'vas/gemfire/locator_logs'
 require 'vas/gemfire/locator_node_instances'
+require 'vas/gemfire/locator_node_live_configurations'
 require 'vas/gemfire/locator_pending_configurations'
 require 'vas/gemfire/nodes'
 require 'vas/gemfire/pending_application_codes'
@@ -67,9 +73,33 @@ require 'vas/rabbitmq/instances'
 require 'vas/rabbitmq/live_configurations'
 require 'vas/rabbitmq/logs'
 require 'vas/rabbitmq/node_instances'
+require 'vas/rabbitmq/node_live_configurations'
 require 'vas/rabbitmq/nodes'
 require 'vas/rabbitmq/pending_configurations'
 require 'vas/rabbitmq/rabbitmq'
+require 'vas/sqlfire/agent_instances'
+require 'vas/sqlfire/agent_live_configurations'
+require 'vas/sqlfire/agent_logs'
+require 'vas/sqlfire/agent_node_instances'
+require 'vas/sqlfire/agent_node_live_configurations'
+require 'vas/sqlfire/agent_pending_configurations'
+require 'vas/sqlfire/groups'
+require 'vas/sqlfire/installation_images'
+require 'vas/sqlfire/installations'
+require 'vas/sqlfire/locator_instances'
+require 'vas/sqlfire/locator_live_configurations'
+require 'vas/sqlfire/locator_logs'
+require 'vas/sqlfire/locator_node_instances'
+require 'vas/sqlfire/locator_node_live_configurations'
+require 'vas/sqlfire/locator_pending_configurations'
+require 'vas/sqlfire/nodes'
+require 'vas/sqlfire/server_instances'
+require 'vas/sqlfire/server_live_configurations'
+require 'vas/sqlfire/server_logs'
+require 'vas/sqlfire/server_node_instances'
+require 'vas/sqlfire/server_node_live_configurations'
+require 'vas/sqlfire/server_pending_configurations'
+require 'vas/sqlfire/sqlfire'
 require 'vas/tc_server/applications'
 require 'vas/tc_server/configuration'
 require 'vas/tc_server/groups'
@@ -80,6 +110,7 @@ require 'vas/tc_server/live_configurations'
 require 'vas/tc_server/logs'
 require 'vas/tc_server/node_applications'
 require 'vas/tc_server/node_instances'
+require 'vas/tc_server/node_live_configurations'
 require 'vas/tc_server/node_revisions'
 require 'vas/tc_server/nodes'
 require 'vas/tc_server/pending_configurations'
@@ -95,4 +126,16 @@ require 'vas/vfabric/agent_image'
 require 'vas/vfabric/nodes'
 require 'vas/vfabric/v_fabric'
 require 'vas/vfabric_administration_server'
+require 'vas/web_server/configuration'
+require 'vas/web_server/groups'
+require 'vas/web_server/installation_images'
+require 'vas/web_server/installations'
+require 'vas/web_server/instances'
+require 'vas/web_server/live_configurations'
+require 'vas/web_server/logs'
+require 'vas/web_server/node_instances'
+require 'vas/web_server/node_live_configurations'
+require 'vas/web_server/nodes'
+require 'vas/web_server/pending_configurations'
+require 'vas/web_server/web_server'
 require 'zip/zipfilesystem'

data/lib/vas/gemfire/agent_instances.rb

@@ -21,7 +21,7 @@ module Gemfire
 
     # @private
     def initialize(location, client)
-      super(location, client, "agent-group-instances", AgentInstance)
+      super(location, client, 'agent-group-instances', AgentInstance)
     end
 
     # Creates a new agent instance
@@ -32,7 +32,7 @@ module Gemfire
     # @return [AgentInstance] the new agent instance
     def create(installation, name)
       payload = { :installation => installation.location, :name => name }
-      AgentInstance.new(client.post(location, payload, "agent-group-instance"), client)
+      super(payload, 'agent-group-instance')
     end
 
   end
@@ -51,7 +51,8 @@ module Gemfire
     #
     # @return [void]
     def update(installation)
-      client.post(location, { :installation => installation.location });
+      client.post(location, { :installation => installation.location })
+      reload
     end
 
   end

data/lib/vas/gemfire/agent_live_configurations.rb

@@ -21,17 +21,17 @@ module Gemfire
 
     # @private
     def initialize(location, client)
-      super(location, client, "live-configurations", AgentLiveConfiguration)
+      super(location, client, 'live-configurations', AgentLiveConfiguration)
     end
 
   end
   
   # A live configuration file in an agent instance
-  class AgentLiveConfiguration < Shared::Configuration
+  class AgentLiveConfiguration < Shared::LiveConfiguration
     
     # @private
     def initialize(location, client)
-      super(location, client, "agent-group-instance", AgentInstance)
+      super(location, client, 'agent-group-instance', AgentInstance, AgentNodeLiveConfiguration)
     end
 
   end

data/lib/vas/gemfire/agent_node_instances.rb

@@ -21,7 +21,7 @@ module Gemfire
 
     # @private
     def initialize(location, client)
-      super(location, client, "agent-node-instances", AgentNodeInstance)
+      super(location, client, 'agent-node-instances', AgentNodeInstance)
     end
 
   end
@@ -31,7 +31,7 @@ module Gemfire
 
     # @private
     def initialize(location, client)
-      super(location, client, Node, AgentLogs, AgentInstance, 'agent-group-instance')
+      super(location, client, Node, AgentLogs, AgentInstance, 'agent-group-instance', AgentNodeLiveConfigurations)
     end
 
   end

data/lib/vas/gemfire/agent_node_live_configurations.rb

@@ -0,0 +1,39 @@
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. 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.
+
+
+module Gemfire
+
+  # Used to enumerate an agent node instance's live configuration
+  class AgentNodeLiveConfigurations < Shared::Collection
+
+    # @private
+    def initialize(location, client)
+      super(location, client, 'node-live-configurations', AgentNodeLiveConfiguration)
+    end
+
+  end
+  
+  # A live configuration file in an agent node instance
+  class AgentNodeLiveConfiguration < Shared::NodeConfiguration
+
+    # @private
+    def initialize(location, client)
+      super(location, client, 'agent-node-instance', AgentNodeInstance, AgentLiveConfiguration)
+    end
+
+  end
+
+end

data/lib/vas/gemfire/application_code.rb

@@ -25,24 +25,25 @@ module Gemfire
     # @return [String] the version of the application code
     attr_reader :version
 
-    # @return [ApplicationCodeImage] the image that was used to create the application code
-    attr_reader :application_code_image
-
-    # @return [CacheServerInstance] the cache server instance that contains the application code
-    attr_reader :instance
-
     # @private
     def initialize(location, client)
       super(location, client)
 
-      @name = details["name"]
-      @version = details["version"]
+      @name = details['name']
+      @version = details['version']
 
-      @application_code_image = ApplicationCodeImage.new(
-          Util::LinkUtils.get_link_href(details, 'application-code-image'), client)
+      @application_code_image_location = Util::LinkUtils.get_link_href(details, 'application-code-image')
+      @instance_location = Util::LinkUtils.get_link_href(details, 'cache-server-group-instance')
+    end
 
-      @instance = CacheServerInstance.new(
-          Util::LinkUtils.get_link_href(details, 'cache-server-group-instance'), client)
+    # @return [ApplicationCodeImage] the image that was used to create the application code
+    def application_code_image
+      @application_code_image ||= ApplicationCodeImage.new(@application_code_image_location, client)
+    end
+
+    # @return [CacheServerInstance] the cache server instance that contains the application code
+    def instance
+      @instance ||= CacheServerInstance.new(@instance_location, client)
     end
 
     # @return [String] a string representation of the application code

data/lib/vas/gemfire/application_code_images.rb

@@ -21,7 +21,7 @@ module Gemfire
 
     # @private
     def initialize(location, client)
-      super(location, client, "application-code-images", ApplicationCodeImage)
+      super(location, client, 'application-code-images', ApplicationCodeImage)
     end
     
     # Creates a new application code image by uploading a file and assigning it a name and version
@@ -32,13 +32,15 @@ module Gemfire
     #
     # @return [ApplicationCodeImage] the new application code image
     def create(path, name, version)
-      ApplicationCodeImage.new(client.post_image(location, path, { :name => name, :version => version }), client)
+      create_image(path, { :name => name, :version => version })
     end
     
   end
   
   # An application code image
   class ApplicationCodeImage < Shared::Resource
+    
+    include Shared::Deletable
 
     # @return [String] the application code image's name
     attr_reader :name
@@ -60,23 +62,23 @@ module Gemfire
 
     # @return [ApplicationCode[]] the live application code that has been created from this application code image
     def live_application_code
-      application_codes = []
-      Util::LinkUtils.get_link_hrefs(client.get(location), "live-application-code").each {
-          |application_code_location| application_codes << ApplicationCode.new(application_code_location, client)}
-      application_codes
+      @live_application_codes ||= create_resources_from_links('live-application-code', ApplicationCode)
     end
 
     # @return [ApplicationCode[]] the pending application code that has been created from this application code image
     def pending_application_code
-      application_codes = []
-      Util::LinkUtils.get_link_hrefs(client.get(location), "pending-application-code").each {
-          |application_code_location| application_codes << ApplicationCode.new(application_code_location, client)}
-      application_codes
+      @pending_application_codes ||= create_resources_from_links('pending-application-code', ApplicationCode)
+    end
+
+    def reload
+      super
+      @live_application_codes = nil
+      @pending_application_codes = nil
     end
 
     # @return [String] a string representation of the application code image
     def to_s
-      "#<#{self.class} name='#@name' version='#@version'>"
+      "#<#{self.class} name='#@name' version='#@version' size='#@size'>"
     end
 
   end

data/lib/vas/gemfire/cache_server_instances.rb

@@ -21,7 +21,7 @@ module Gemfire
 
     # @private
     def initialize(location, client)
-      super(location, client, "cache-server-group-instances", CacheServerInstance)
+      super(location, client, 'cache-server-group-instances', CacheServerInstance)
     end
 
     # Creates a new cache server instance
@@ -32,7 +32,7 @@ module Gemfire
     # @return [CacheServerInstance] the new cache server instance
     def create(installation, name)
       payload = { :installation => installation.location, :name => name }
-      CacheServerInstance.new(client.post(location, payload, "cache-server-group-instance"), client)
+      super(payload, 'cache-server-group-instance')
     end
 
   end
@@ -40,17 +40,14 @@ module Gemfire
   # A cache server instance
   class CacheServerInstance < Shared::Instance
 
-    # @return [LiveApplicationCodes] the instance's live application code
-    attr_reader :live_application_code
-
-    # @return [PendingApplicationCodes] the instance's pending application code
-    attr_reader :pending_application_code
-
     # @private
     def initialize(location, client)
-      super(location, client, Group, Installation, CacheServerLiveConfigurations, CacheServerPendingConfigurations, CacheServerNodeInstance, 'cache-server-node-instance')
-      @live_application_code = LiveApplicationCodes.new(Util::LinkUtils.get_link_href(details, 'live-application-code'), client)
-      @pending_application_code = PendingApplicationCodes.new(Util::LinkUtils.get_link_href(details, 'pending-application-code'), client)
+      super(location, client, Group, Installation, CacheServerLiveConfigurations, CacheServerPendingConfigurations,
+            CacheServerNodeInstance, 'cache-server-node-instance')
+
+      @live_application_code_location = Util::LinkUtils.get_link_href(details, 'live-application-code')
+      @pending_application_code_location = Util::LinkUtils.get_link_href(details, 'pending-application-code')
+
     end
 
     # Updates the instance to use a different installation
@@ -59,7 +56,18 @@ module Gemfire
     #
     # @return [void]
     def update(installation)
-      client.post(location, { :installation => installation.location });
+      client.post(location, { :installation => installation.location })
+      reload
+    end
+
+    # @return [LiveApplicationCodes] the instance's live application code
+    def live_application_code
+      @live_application_code ||= LiveApplicationCodes.new(@live_application_code_location, client)
+    end
+
+    # @return [PendingApplicationCodes] the instance's pending application code
+    def pending_application_code
+      @pending_application_code ||= PendingApplicationCodes.new(@pending_application_code_location, client)
     end
 
   end

data/lib/vas/gemfire/cache_server_live_configurations.rb

@@ -21,17 +21,17 @@ module Gemfire
 
     # @private
     def initialize(location, client)
-      super(location, client, "live-configurations", CacheServerLiveConfiguration)
+      super(location, client, 'live-configurations', CacheServerLiveConfiguration)
     end
 
   end
   
   # A live configuration file in a cache server instance
-  class CacheServerLiveConfiguration < Shared::Configuration
+  class CacheServerLiveConfiguration < Shared::LiveConfiguration
 
     # @private
     def initialize(location, client)
-      super(location, client, "cache-server-group-instance", CacheServerInstance)
+      super(location, client, 'cache-server-group-instance', CacheServerInstance, CacheServerNodeLiveConfiguration)
     end
 
   end

data/lib/vas/gemfire/cache_server_node_instances.rb

@@ -21,7 +21,7 @@ module Gemfire
 
     # @private
     def initialize(location, client)
-      super(location, client, "cache-server-node-instances", CacheServerNodeInstance)
+      super(location, client, 'cache-server-node-instances', CacheServerNodeInstance)
     end
 
   end
@@ -29,17 +29,24 @@ module Gemfire
   # A cache server node instance
   class CacheServerNodeInstance < Shared::NodeInstance
 
+    # @private
+    def initialize(location, client)
+      super(location, client, Node, CacheServerLogs, CacheServerInstance, 'cache-server-group-instance',
+            CacheServerNodeLiveConfigurations)
+
+      @disk_stores_location = Util::LinkUtils.get_link_href(details, 'disk-stores')
+      @statistics_location = Util::LinkUtils.get_link_href(details, 'statistics')
+
+    end
+
     # @return [DiskStores] the instance's disk stores
-    attr_reader :disk_stores
+    def disk_stores
+      @disk_stores ||= DiskStores.new(@disk_stores_location, client)
+    end
 
     # @return [Statistics] the instance's statistics
-    attr_reader :statistics
-
-    # @private
-    def initialize(location, client)
-      super(location, client, Node, CacheServerLogs, CacheServerInstance, 'cache-server-group-instance')
-      @disk_stores = DiskStores.new(Util::LinkUtils.get_link_href(details, 'disk-stores'), client)
-      @statistics = Statistics.new(Util::LinkUtils.get_link_href(details, 'statistics'), client)
+    def statistics
+      @statistics ||= Statistics.new(@statistics_location, client)
     end
 
   end

data/lib/vas/gemfire/cache_server_node_live_configurations.rb

@@ -0,0 +1,39 @@
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. 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.
+
+
+module Gemfire
+
+  # Used to enumerate a cache server node instance's live configuration
+  class CacheServerNodeLiveConfigurations < Shared::Collection
+
+    # @private
+    def initialize(location, client)
+      super(location, client, 'node-live-configurations', CacheServerNodeLiveConfiguration)
+    end
+
+  end
+  
+  # A live configuration file in a cache server node instance
+  class CacheServerNodeLiveConfiguration < Shared::NodeConfiguration
+
+    # @private
+    def initialize(location, client)
+      super(location, client, 'cache-server-node-instance', CacheServerNodeInstance, CacheServerLiveConfiguration)
+    end
+
+  end
+
+end