# frozen_string_literal: true # Store object full path in separate table for easy lookup and uniq validation # Object must have name and path db fields and respond to parent and parent_changed? methods. module Routable extend ActiveSupport::Concern include CaseSensitivity # Finds a Routable object by its full path, without knowing the class. # # Usage: # # Routable.find_by_full_path('groupname') # -> Group # Routable.find_by_full_path('groupname/projectname') # -> Project # # Returns a single object, or nil. def self.find_by_full_path(path, follow_redirects: false, route_scope: Route, redirect_route_scope: RedirectRoute) return unless path.present? # Case sensitive match first (it's cheaper and the usual case) # If we didn't have an exact match, we perform a case insensitive search # # We need to qualify the columns with the table name, to support both direct lookups on # Route/RedirectRoute, and scoped lookups through the Routable classes. route = route_scope.find_by(routes: { path: path }) || route_scope.iwhere(Route.arel_table[:path] => path).take if follow_redirects route ||= redirect_route_scope.iwhere(RedirectRoute.arel_table[:path] => path).take end return unless route route.is_a?(Routable) ? route : route.source end included do # Remove `inverse_of: source` when upgraded to rails 5.2 # See https://github.com/rails/rails/pull/28808 has_one :route, as: :source, autosave: true, dependent: :destroy, inverse_of: :source # rubocop:disable Cop/ActiveRecordDependent has_many :redirect_routes, as: :source, autosave: true, dependent: :destroy # rubocop:disable Cop/ActiveRecordDependent validates :route, presence: true, unless: -> { is_a?(Namespaces::ProjectNamespace) } scope :with_route, -> { includes(:route) } after_validation :set_path_errors before_validation :prepare_route before_save :prepare_route # in case validation is skipped end class_methods do # Finds a single object by full path match in routes table. # # Usage: # # Klass.find_by_full_path('gitlab-org/gitlab-foss') # # Returns a single object, or nil. def find_by_full_path(path, follow_redirects: false) # TODO: Optimize these queries by avoiding joins # https://gitlab.com/gitlab-org/gitlab/-/issues/292252 Routable.find_by_full_path( path, follow_redirects: follow_redirects, route_scope: includes(:route).references(:routes), redirect_route_scope: joins(:redirect_routes) ) end # Builds a relation to find multiple objects by their full paths. # # Usage: # # Klass.where_full_path_in(%w{gitlab-org/gitlab-foss gitlab-org/gitlab}) # # Returns an ActiveRecord::Relation. def where_full_path_in(paths, use_includes: true) return none if paths.empty? wheres = paths.map do |path| "(LOWER(routes.path) = LOWER(#{connection.quote(path)}))" end route = if use_includes includes(:route).references(:routes) else joins(:route) end route.where(wheres.join(' OR ')) end end def full_name # We have to test for persistence as the cache key uses #updated_at return (route&.name || build_full_name) unless persisted? && Feature.enabled?(:cached_route_lookups, self, type: :ops, default_enabled: :yaml) # Return the name as-is if the parent is missing return name if route.nil? && parent.nil? && name.present? # If the route is already preloaded, return directly, preventing an extra load return route.name if route_loaded? && route.present? # Similarly, we can allow the build if the parent is loaded return build_full_name if parent_loaded? Gitlab::Cache.fetch_once([cache_key, :full_name]) do route&.name || build_full_name end end def full_path # We have to test for persistence as the cache key uses #updated_at return (route&.path || build_full_path) unless persisted? && Feature.enabled?(:cached_route_lookups, self, type: :ops, default_enabled: :yaml) # Return the path as-is if the parent is missing return path if route.nil? && parent.nil? && path.present? # If the route is already preloaded, return directly, preventing an extra load return route.path if route_loaded? && route.present? # Similarly, we can allow the build if the parent is loaded return build_full_path if parent_loaded? Gitlab::Cache.fetch_once([cache_key, :full_path]) do route&.path || build_full_path end end # Overriden in the Project model # parent_id condition prevents issues with parent reassignment def parent_loaded? association(:parent).loaded? end def route_loaded? association(:route).loaded? end def full_path_components full_path.split('/') end def build_full_path if parent && path parent.full_path + '/' + path else path end end # Group would override this to check from association def owned_by?(user) owner == user end private def set_path_errors route_path_errors = self.errors.delete(:"route.path") route_path_errors&.each do |msg| self.errors.add(:path, msg) end end def full_name_changed? name_changed? || parent_changed? end def full_path_changed? path_changed? || parent_changed? end def build_full_name if parent && name parent.human_name + ' / ' + name else name end end def prepare_route return unless full_path_changed? || full_name_changed? return if is_a?(Namespaces::ProjectNamespace) route || build_route(source: self) route.path = build_full_path route.name = build_full_name route.namespace = if is_a?(Namespace) self elsif is_a?(Project) self.project_namespace end end end