Merge pull request #10 from phantom94/patch-1
[gitphp.git] / include / git / GitObject.class.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
<?php
/**
 * Base class for all hash objects in a git repository
 *
 * @author Christopher Han <xiphux@gmail.com>
 * @copyright Copyright (c) 2010 Christopher Han
 * @package GitPHP
 * @subpackage Git
 */
abstract class GitPHP_GitObject
{
        /**
         * The project
         *
         * @var GitPHP_Project
         */
        protected $project;
 
        /**
         * The hash of the object
         *
         * @var string
         */
        protected $hash;
 
        /**
         * The abbreviated hash of the object
         *
         * @var string
         */
        protected $abbreviatedHash;
 
        /**
         * Whether the abbreviated hash has been loaded
         *
         * @var boolean
         */
        protected $abbreviatedHashLoaded = false;
 
        /**
         * Instantiates object
         *
         * @param GitPHP_Project $project the project
         * @param string $hash object hash
         */
        public function __construct($project, $hash)
        {
                $this->project = $project;
                $this->SetHash($hash);
        }
 
        /**
         * Gets the project
         *
         * @return GitPHP_Project project
         */
        public function GetProject()
        {
                return $this->project;
        }
 
        /**
         * Sets the project
         *
         * @param GitPHP_Project $project project
         */
        public function SetProject($project)
        {
                $this->project = $project;
        }
 
        /**
         * Gets the hash
         *
         * @param boolean $abbreviate true to abbreviate hash
         * @return string object hash
         */
        public function GetHash($abbreviate = false)
        {
                if ($abbreviate) {
                        if (!$this->abbreviatedHashLoaded) {
                                $this->abbreviatedHash = $this->GetProject()->AbbreviateHash($this->hash);
                                $this->abbreviatedHashLoaded = true;
                        }
 
                        if (!empty($this->abbreviatedHash)) {
                                return $this->abbreviatedHash;
                        }
                }
 
                return $this->hash;
        }
 
        /**
         * Attempts to set the hash of this object
         *
         * @param string $hash the hash to set
         * @throws Exception on invalid hash
         */
        protected function SetHash($hash)
        {
                if (!preg_match('/^[0-9A-Fa-f]{40}$/', $hash)) {
                        throw new GitPHP_InvalidHashException($hash);
                }
                $this->hash = $hash;
        }
 
        /**
         * Called to prepare the object for serialization
         *
         * @return string[] list of properties to serialize
         */
        public function __sleep()
        {
                return array('hash');
        }
 
        /**
         * Gets the cache key to use for this object
         *
         * @return string cache key
         */
        public function GetCacheKey()
        {
                return 'project|' . $this->project;
        }
 
}
 
comments