Exceptional exceptions

Exceptional Exceptions
with @LlewellynFalco & @JamesRCounts

http://youtu.be/k6C_HjWr3Nk?t=3m30s
Eddie Izzard’s printer

Rules
1. All code must compile
2. All exceptions must be thrown because of standard calls to the .Net BCL
3. All improvements must be possible

Today’s Goal
The next time you write
throw new Exception(…);
…you will remember this talk

11
12
13
14
var a = Router.GetRoute("A");
var b = Router.GetRoute("B");
var c = Router.GetRoute("C");
var result = new Helper(a.From, b.To, c.ViaProxy).Send();
System.NullReferenceException: Object reference not set to an instance
of an object.
at ExceptionalExamples.UnitTests.NullRef() in UnitTest1.cs: line 14
What is null?
A) a
B) b
C) c
D) I don’t know

IL_0028: ldloc.1
IL_0029: callvirt instance object ExceptionalExamples.Route::get_To()
Null reference while executing: Route.To
throw new NullReferenceException(
"Null reference while executing: {0}.{1}",
m.ClassName,
m.MethodSignature());
throw new NullReferenceException(“Object reference not set to an instance of an object.”)
Object reference not set to an instance of an object.

11
12
13
14
var a = Router.GetRoute("A");
var b = Router.GetRoute("B");
var c = Router.GetRoute("C");
var result = new Helper(a.From, b.To, c.ViaProxy).Send();
System.NullReferenceException:
Null reference while executing: Route.To
at ExceptionalExamples.UnitTests.NullRef() in UnitTest1.cs: line 14
What is null?
A) a
B) b
C) c
D) I don’t know

This exception proves the rule…
“Print variable values
in your error messages”
…to give the confused coder some guidance

System.OutOfMemoryException: Out of memory.
at LinearGradientBrush..ctor(Point p1, Point p2, Color c1, Color c2)
at MyForm.OnPaint(PaintEventArgs e) in c:...UnitTest1.cs:line 64
at Control.PaintWithErrorHandling(PaintEventArgs e, Int16 layer)
at Control.OnPrint(PaintEventArgs e)
What went wrong?
A) 10,000 rectangles
B) Brush too big
C) Garbage Collection
D) Other
58
59
60
61
62
63
64
65
66
67
for (var i = 0; i < 10000; i++)
{
int w = random.Next(this.Width);
int h = random.Next(this.Height);
var start = new Point(0, 0);
var end = new Point(w, h);
var b = new LinearGradientBrush(start, end, Color.Red, Color.Blue);
var rect = new Rectangle(random.Next(Width), random.Next(Height), w, h);
e.Graphics.FillRectangle(b, rect);
}

A) new LinearGradientBrush(new Point(0, 0), new Point(w, h), Color.Red, Color.Blue);
B) new LinearGradientBrush(new Rectangle(0, 0, w, h), Color.Red, Color.Blue, 1.0f);
Rectangle '{X=0,Y=0,Width=189,Height=0}' cannot have a width or height equal to 0.
throw new ArgumentException(
@"Rectangle ‘{{X={0},Y={1},Width={2},Height={3}}}'
cannot have a width or height equal to 0.",
start.X, start.Y, end.X - start.X, end.Y - start.Y);
throw new OutOfMemoryException(“Out of memory.”)
Out of memory

Rectangle '{X=0,Y=0,Width=189,Height=0}' cannot have a width or height
equal to 0.
at LinearGradientBrush..ctor(Point p1, Point p2, Color c1, Color c2)
at MyForm.OnPaint(PaintEventArgs e) in c:...UnitTest1.cs:line 64
at Control.PaintWithErrorHandling(PaintEventArgs e, Int16 layer)
at Control.OnPrint(PaintEventArgs e)
What went wrong?
A) 10,000 rectangles
B) Brush too big
C) Garbage Collection
D) Other
58
59
60
61
62
63
64
65
66
67
for (var i = 0; i < 10000; i++)
{
int w = random.Next(this.Width);
int h = random.Next(this.Height);
var start = new Point(0, 0);
var end = new Point(w, h);
var b = new LinearGradientBrush(start, end, Color.Red, Color.Blue);
var rect = new Rectangle(random.Next(Width), random.Next(Height), w, h);
e.Graphics.FillRectangle(b, rect);
}
Height is 0

“If the framework gives you bad
exceptions, throw better ones”

“Print other variables to provide context”
Rectangle '{X=0,Y=0,Width=189,Height=0}'

System.InvalidCastException: At least one element in the source array could not be cast down
to the destination array type.
at System.Array.Copy(Array s, Array d, Int32 l)
at UnitTests.ArrayCopy() in UnitTest1.cs: line 13
What doesn’t fit?
A) Button
B) Form
C) ToolTip
D) I don’t know
11
12
13
Component[] from = { new Button(), new Form(), new ToolTip(), };
Component[] to = new Collage().GetMemories();
Array.Copy(from, to, from.Length);

<Form> could not be cast to destination array type <Control[]>
throw new InvalidCastException(
"<{0}> could not be cast to destination array type <{1}>",
element.GetType().Name, to.GetType().Name);
throw new InvalidCastException (“…text…”)
At least one element in the source array could not be cast down to
the destination array type.
Array.Copy(from, to, from.Length);13

System.InvalidCastException: <Form> could not be cast to destination array type <Control[]>
at System.Array.Copy(Array s, Array d, Int32 l)
at UnitTests.ArrayCopy() in UnitTest1.cs: line 13
What doesn’t fit?
A) Button
B) Form
C) ToolTip
D) I don’t know
11
12
13
Component[] from = { new Button(), new Form(), new ToolTip(), };
Component[] to = new Collage().GetMemories();
Array.Copy(from, to, from.Length);

“Runtime details make it clear where the
error comes from”

System.FormatException: The string was not recognized as a valid
DateTime. There is an unknown word starting at index 7.
at System.DateTimeParse.Parse(String s, DateTimeFormatInfo dtfi, DateTimeStyles styles)
at System.DateTime.Parse(String s)
at ExceptionalExamples.UnitTests.DateTimeParse() in UnitTest1.cs: line 75
How do you need to sanitize the date?
A) Include CultureInfo
B) Remove “th”
C) Only use first three letters of the month
D) Other
75 var dateTime = DateTime.Parse(form.Date);

Cannot parse "March 6th 2010“ at index 7
Valid formats include:
"<Month> <Day> <Year>" => “January 14 2010”
"<Month>/<Day>/<Year>" => “1/14/2010”
"<Year>-<Month>-<Day>" => “2010-01-24”
throw new FormatException(@"Cannot parse '{0}' at index {1}
Valid formats include: {2}",
input, 7, tldr);
throw new FormatException (“…text…” + index)
The string was not recognized as a valid DateTime. There is an
unknown word starting at index 7
75 var dateTime = DateTime.Parse(form.Date);

75
System.FormatException: Cannot parse "March 6th 2010" at index 7
Valid formats include:
"<Month> <Day> <Year>" => "January 14 2010"
"<Month>/<Day>/<Year>" => "1/14/2010"
"<Year>-<Month>-<Day>" => "2010-01-24"
at System.DateTimeParse.Parse(String s, DateTimeFormatInfo dtfi, DateTimeStyles styles)
at System.DateTime.Parse(String s)
at ExceptionalExamples.UnitTests.DateTimeParse() in UnitTest1.cs: line 75
How do you need to sanitize the date?
A) Include CultureInfo
B) Remove “th”
C) Only us first three letters of the month
D) Other
var dateTime = DateTime.Parse(form.Date);

“Show tl;dr examples if
particular formats are required”

Touching your privates
in public

82
83
84
85
86
System.MissingMethodException:
Method 'System.Windows.Forms.ButtonBase.GetFlag' not found.
at System.RuntimeType.InvokeMember(String name, BindingFlags bindingFlags, …)
at ExceptionalExamples.UnitTests.ButtonAnimation() in UnitTest1.cs: line 85
What went wrong?
A) Not on ButtonBase
B) Wrong parameters
C) Docs are out of date
D) Other
var su = new SignUpPrompt();
su.Advertise();
var pb = new PrivateObject(su.BuyButton, new PrivateType(typeof(ButtonBase)));
var isAnimating = (bool)pb.Invoke("GetFlag", new[] { 0x0010 });
Assert.IsTrue(isAnimating);
private bool GetFlag(int flag)

Cannot find method: GetFlag(int[]).
Possible methods starting with “G” are:
GetFlag(int)
GetPreferedSizeCore(Size)
Common Fixes
If method not listed it might be on a base class
i.e. new PrivateObject(o, new PrivateType(typeof(BaseClass)))
If method is listed check your parameter list
i.e. p.Invoke(“MethodName”, param1, param2)
throw new MissingMethodException (“…text…” + method + “…text…”)
Method 'System.Windows.Forms.ButtonBase.GetFlag' not found.
85 var isAnimating = (bool)pb.Invoke("GetFlag", new[] { 0x0010 });

throw new MissingMethodException(@"Cannot find method: {0}.
Possible methods starting with “{1}” are:n{2}
Common Fixesn{3}“,
method, method[0], this.GetMethodsStartingWith(method[0]),
commonFixes);

82
83
84
85
86
Cannot find method: GetFlag(int[]).
GetFlag(int)
GetPreferedSizeCore(Size)
Common Fixes
What went wrong?
A) Not on ButtonBase
B) Wrong parameters
D) Other
su.Advertise();
var pb = new PrivateObject(su.BuyButton, new PrivateType(typeof(ButtonBase)));
var isAnimating = (bool)pb.Invoke("GetFlag", new[] { 0x0010 });

“Don’t hold back,
You don’t know which clue will help”

82
83
84
85
86
Cannot find method: GetFlag(int).
<none>
Common Fixes
What went wrong?
A) Not on Button
B) Wrong parameters
D) Other
su.Advertise();
var pb = new PrivateObject(su.BuyButton);
var isAnimating = (bool)pb.Invoke("GetFlag", 0x0010);

Don’t disturb the
natives
…or Dynamically Lost Library

82
...
100
101
System.DllNotFoundException:
Unable to load DLL 'libsvn_client-1-0.dll':
The specified module could not be found.
(Exception from HRESULT: 0x8007007E)
at ExceptionalExamples.NativeDll.svn_client_info()
at ExceptionalExamples.UnitTests.NativeTest() in UnitTest1.cs: line 82
Why can’t we find the DLL?
A) Wrong File Permissions
B) Wrong Working Directory
C) Wrong Processor Arch
D) Other
NativeDll.svn_client_info();
[DllImport("libsvn_client-1-0.dll")]
public static extern int svn_client_info();
06/25/2014 09:59 PM 10,240 ExceptionalExamples.dll
06/03/2014 06:11 AM 255,849 libsvn_client-1-0.dll
2 File(s) 266,089 bytes

Problems loading dependencies for
“libsvn_client-1-0.dll”.
Could not find dependency: “MSYS-1.0.dll”
Required libraries:
MSYS-1.0.dll
LIBSVN_DELTA-1-0.DLL
LIBSVN_DIFF-1-0.DLL
LIBAPR-0-0.DLL
LIBSVN_SUBR-1-0.DLL
throw new DllNotFoundException (“…text…” + index)
Unable to load DLL 'libsvn_client-1-0.dll':
The specified module could not be found.
(Exception from HRESULT: 0x8007007E)
100 [DllImport("libsvn_client-1-0.dll")]

throw new DllNotFoundException(@"Problems loading
dependencies for '{0}'.
Could not find dependency: '{1}'
Required libraries:n{2}",
dll,
missingDependancy,
allDependancies.ToReadableString());

82
...
100
101
System.DllNotFoundException:
Problems loading dependencies for “libsvn_client-1-0.dll”.
Could not find dependency: “MSYS-1.0.dll”
Required libraries:
MSYS-1.0.dll
LIBSVN_DELTA-1-0.DLL
LIBSVN_DIFF-1-0.DLL
LIBAPR-0-0.DLL
LIBSVN_SUBR-1-0.DLL
at ExceptionalExamples.NativeDll.svn_client_info()
at ExceptionalExamples.UnitTests.NativeTest() in UnitTest1.cs: line 82
Why can’t we find the DLL?
A) Wrong File Permissions
B) Wrong Working Directory
C) Wrong Processor Arch
D) Other
NativeDll.svn_client_info();
[DllImport("libsvn_client-1-0.dll")]
public static extern int svn_client_info();
06/25/2014 09:59 PM 10,240 ExceptionalExamples.dll
06/03/2014 06:11 AM 255,849 libsvn_client-1-0.dll
2 File(s) 266,089 bytes

“Highlight root causes”

Use variable values
Wrap bad exceptions
Provide context
Show runtime details
tl;dr examples
Extra information
Highlight root causes

Approval Tests 20 episode youtube series

Contact Information
@LlewellynFalco
http://LlewellynFalco.Blogspot.com
@JamesRCounts
http://IHadThisIdeaOnce.com
Slides at http://lfal.co/ExceptionalExceptions

Exceptional exceptions

Related slideshows

More Related Content

Exceptional exceptions