1 /*
2 * Copyright (C) 2010, Christian Halstrick <christian.halstrick@sap.com> and
3 * other copyright owners as documented in the project's IP log.
4 *
5 * This program and the accompanying materials are made available under the
6 * terms of the Eclipse Distribution License v1.0 which accompanies this
7 * distribution, is reproduced below, and is available at
8 * http://www.eclipse.org/org/documents/edl-v10.php
9 *
10 * All rights reserved.
11 *
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions are met:
14 *
15 * - Redistributions of source code must retain the above copyright notice, this
16 * list of conditions and the following disclaimer.
17 *
18 * - Redistributions in binary form must reproduce the above copyright notice,
19 * this list of conditions and the following disclaimer in the documentation
20 * and/or other materials provided with the distribution.
21 *
22 * - Neither the name of the Eclipse Foundation, Inc. nor the names of its
23 * contributors may be used to endorse or promote products derived from this
24 * software without specific prior written permission.
25 *
26 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
27 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
29 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
30 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
31 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
32 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
33 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
34 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
35 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
36 * POSSIBILITY OF SUCH DAMAGE.
37 */
38 package org.eclipse.jgit.api.errors;
39
40 import java.text.MessageFormat;
41
42 import org.eclipse.jgit.internal.JGitText;
43 import org.eclipse.jgit.lib.Ref;
44 import org.eclipse.jgit.lib.RefUpdate;
45
46 /**
47 * Exception thrown when a command wants to update a ref but failed because
48 * another process is accessing (or even also updating) the ref.
49 *
50 * @see org.eclipse.jgit.lib.RefUpdate.Result#LOCK_FAILURE
51 */
52 public class ConcurrentRefUpdateException extends GitAPIException {
53 private static final long serialVersionUID = 1L;
54 private RefUpdate.Result rc;
55 private Ref ref;
56
57 /**
58 * @param message
59 * @param ref
60 * @param rc
61 * @param cause
62 */
63 public ConcurrentRefUpdateException(String message, Ref ref,
64 RefUpdate.Result rc, Throwable cause) {
65 super((rc == null) ? message : message + ". " //$NON-NLS-1$
66 + MessageFormat.format(JGitText.get().refUpdateReturnCodeWas, rc), cause);
67 this.rc = rc;
68 this.ref = ref;
69 }
70
71 /**
72 * @param message
73 * @param ref
74 * @param rc
75 */
76 public ConcurrentRefUpdateException(String message, Ref ref,
77 RefUpdate.Result rc) {
78 super((rc == null) ? message : message + ". " //$NON-NLS-1$
79 + MessageFormat.format(JGitText.get().refUpdateReturnCodeWas, rc));
80 this.rc = rc;
81 this.ref = ref;
82 }
83
84 /**
85 * @return the {@link Ref} which was tried to by updated
86 */
87 public Ref getRef() {
88 return ref;
89 }
90
91 /**
92 * @return the result which was returned by {@link RefUpdate#update()} and
93 * which caused this error
94 */
95 public RefUpdate.Result getResult() {
96 return rc;
97 }
98 }