class Note < ActiveRecord::Base extend ActiveModel::Naming include Gitlab::CurrentSettings include Participable include Mentionable include Awardable include Importable # Attribute containing rendered and redacted Markdown as generated by # Banzai::ObjectRenderer. attr_accessor :note_html # An Array containing the number of visible references as generated by # Banzai::ObjectRenderer attr_accessor :user_visible_reference_count default_value_for :system, false attr_mentionable :note, pipeline: :note participant :author belongs_to :project belongs_to :noteable, polymorphic: true, touch: true belongs_to :author, class_name: "User" belongs_to :updated_by, class_name: "User" has_many :todos, dependent: :destroy has_many :events, as: :target, dependent: :destroy delegate :gfm_reference, :local_reference, to: :noteable delegate :name, to: :project, prefix: true delegate :name, :email, to: :author, prefix: true delegate :title, to: :noteable, allow_nil: true validates :note, :project, presence: true # Attachments are deprecated and are handled by Markdown uploader validates :attachment, file_size: { maximum: :max_attachment_size } validates :noteable_type, presence: true validates :noteable_id, presence: true, unless: [:for_commit?, :importing?] validates :commit_id, presence: true, if: :for_commit? validates :author, presence: true validate unless: [:for_commit?, :importing?] do |note| unless note.noteable.try(:project) == note.project errors.add(:invalid_project, 'Note and noteable project mismatch') end end mount_uploader :attachment, AttachmentUploader # Scopes scope :for_commit_id, ->(commit_id) { where(noteable_type: "Commit", commit_id: commit_id) } scope :system, ->{ where(system: true) } scope :user, ->{ where(system: false) } scope :common, ->{ where(noteable_type: ["", nil]) } scope :fresh, ->{ order(created_at: :asc, id: :asc) } scope :inc_author_project, ->{ includes(:project, :author) } scope :inc_author, ->{ includes(:author) } scope :inc_author_project_award_emoji, ->{ includes(:project, :author, :award_emoji) } scope :diff_notes, ->{ where(type: ['LegacyDiffNote', 'DiffNote']) } scope :non_diff_notes, ->{ where(type: ['Note', nil]) } scope :with_associations, -> do # FYI noteable cannot be loaded for LegacyDiffNote for commits includes(:author, :noteable, :updated_by, project: [:project_members, { group: [:group_members] }]) end before_validation :nullify_blank_type, :nullify_blank_line_code after_save :keep_around_commit class << self def model_name ActiveModel::Name.new(self, nil, 'note') end def build_discussion_id(noteable_type, noteable_id) [:discussion, noteable_type.try(:underscore), noteable_id].join("-") end def discussions all.group_by(&:discussion_id).values end def grouped_diff_notes diff_notes.select(&:active?).sort_by(&:created_at).group_by(&:line_code) end # Searches for notes matching the given query. # # This method uses ILIKE on PostgreSQL and LIKE on MySQL. # # query - The search query as a String. # as_user - Limit results to those viewable by a specific user # # Returns an ActiveRecord::Relation. def search(query, as_user: nil) table = arel_table pattern = "%#{query}%" Note.joins('LEFT JOIN issues ON issues.id = noteable_id'). where(table[:note].matches(pattern)). merge(Issue.visible_to_user(as_user)) end end def cross_reference? system && SystemNoteService.cross_reference?(note) end def diff_note? false end def legacy_diff_note? false end def new_diff_note? false end def active? true end def discussion_id @discussion_id ||= if for_merge_request? [:discussion, :note, id].join("-") else self.class.build_discussion_id(noteable_type, noteable_id || commit_id) end end def max_attachment_size current_application_settings.max_attachment_size.megabytes.to_i end def hook_attrs attributes end def for_commit? noteable_type == "Commit" end def for_issue? noteable_type == "Issue" end def for_merge_request? noteable_type == "MergeRequest" end def for_snippet? noteable_type == "Snippet" end # override to return commits, which are not active record def noteable if for_commit? project.commit(commit_id) else super end # Temp fix to prevent app crash # if note commit id doesn't exist rescue nil end # FIXME: Hack for polymorphic associations with STI # For more information visit http://api.rubyonrails.org/classes/ActiveRecord/Associations/ClassMethods.html#label-Polymorphic+Associations def noteable_type=(noteable_type) super(noteable_type.to_s.classify.constantize.base_class.to_s) end # Reset notes events cache # # Since we do cache @event we need to reset cache in special cases: # * when a note is updated # * when a note is removed # Events cache stored like events/23-20130109142513. # The cache key includes updated_at timestamp. # Thus it will automatically generate a new fragment # when the event is updated because the key changes. def reset_events_cache Event.reset_event_cache_for(self) end def editable? !system? end def cross_reference_not_visible_for?(user) cross_reference? && !has_referenced_mentionables?(user) end def has_referenced_mentionables?(user) if user_visible_reference_count.present? user_visible_reference_count > 0 else referenced_mentionables(user).any? end end def award_emoji? can_be_award_emoji? && contains_emoji_only? end def emoji_awardable? !system? end def can_be_award_emoji? noteable.is_a?(Awardable) end def contains_emoji_only? note =~ /\A#{Banzai::Filter::EmojiFilter.emoji_pattern}\s?\Z/ end def award_emoji_name note.match(Banzai::Filter::EmojiFilter.emoji_pattern)[1] end private def keep_around_commit project.repository.keep_around(self.commit_id) end def nullify_blank_type self.type = nil if self.type.blank? end def nullify_blank_line_code self.line_code = nil if self.line_code.blank? end end